Set-Clipboard
Legt den Inhalt der Zwischenablage fest.
Syntax
Default (Standardwert)
Set-Clipboard
[-Value] <string[]>
[-Append]
[-PassThru]
[-AsOSC52]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Beschreibung
Das Cmdlet Set-Clipboard legt den Inhalt der Zwischenablage fest.
Hinweis
Unter Linux erfordert dieses Cmdlet, dass das hilfsprogramm xclip sich im Pfad befindet. Unter macOS verwendet dieses Cmdlet die pbcopy Nutzen.
Beispiele
Beispiel 1: Kopieren von Text in die Zwischenablage
Set-Clipboard -Value "This is a test string"
Beispiel 2: Kopieren des Inhalts einer Datei in die Zwischenablage
In diesem Beispiel wird der Inhalt einer Datei, eines öffentlichen SSH-Schlüssels, in die Zwischenablage übertragen. Anschließend kann der Schlüssel in eine andere Anwendung eingefügt werden, z. B. GitHub.
Get-Content C:\Users\user1\.ssh\id_ed25519.pub | Set-Clipboard
Beispiel 3: Kopieren von Text in die Zwischenablage des lokalen Hosts über eine SSH-Remotesitzung
Mit dem AsOSC52--Parameter können Sie die Zwischenablage des lokalen Computers festlegen, wenn eine Verbindung mit einer Remotesitzung über SSH hergestellt wird.
Set-Clipboard -Value "This is a test string" -AsOSC52
Beispiel 4: Festlegen des Standardwerts des Parameters **AsOSC52**
Sie können erkennen, ob Sie über SSH mit einer Remotesitzung verbunden sind, indem Sie den Wert der $Env:SSH_CLIENT- oder $Env:SSH_TTY Umgebungsvariablen überprüfen. Wenn eine dieser Variablen festgelegt ist, sind Sie über SSH mit einer Remotesitzung verbunden. Mit diesen Informationen können Sie den Standardwert des AsOSC52--Parameters festlegen. Fügen Sie ihrem PowerShell-Profilskript eine der folgenden Zeilen hinzu.
$PSDefaultParameterValues['Set-Clipboard:AsOSC52'] = $Env:SSH_CLIENT
$PSDefaultParameterValues['Set-Clipboard:AsOSC52'] = $Env:SSH_TTY
Weitere Informationen zu $PSDefaultParameterValuesfinden Sie unter about_Parameters_Default_Values.
Parameter
-Append
Gibt an, dass das Cmdlet der Zwischenablage hinzugefügt werden soll, anstatt es zu ersetzen. Standardmäßig löscht das Cmdlet den aktuellen Inhalt aus der Zwischenablage und legt ihn auf den neuen Inhalt fest. Wenn dieser Parameter angegeben wird, fügt das Cmdlet den neuen Inhalt nach einer Neuen zeile an den aktuellen Inhalt an.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-AsOSC52
Wenn eine Verbindung mit einer Remotesitzung über SSH hergestellt wird, legt Set-Clipboard die Zwischenablage des Remotecomputers und nicht den lokalen Host fest. Wenn Sie diesen Parameter verwenden, verwendet Set-Clipboard die OSC52 ANSI-Escapesequenz, um die Zwischenablage des lokalen Computers festzulegen.
Damit dieses Feature funktioniert, muss Ihre Terminalanwendung die ANSI-Escapesequenz OSC52 unterstützen. Das Windows Terminal unterstützt dieses Feature.
Dieser Parameter wurde in PowerShell 7.4 hinzugefügt.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
| Aliase: | ToLocalhost |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Confirm
Fordert Sie zur Bestätigung auf, bevor Sie das Cmdlet ausführen.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | False |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
| Aliase: | vgl |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-PassThru
Gibt ein Objekt zurück, das das Element darstellt, mit dem Sie arbeiten. Standardmäßig generiert dieses Cmdlet keine Ausgabe.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | False |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Value
Die Zeichenfolgenwerte, die der Zwischenablage hinzugefügt werden sollen.
Parametereigenschaften
| Typ: | String[] |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | True |
| Wert aus Pipeline: | True |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
-WhatIf
Zeigt, was passiert, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | False |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
| Aliase: | Wi |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
CommonParameters
Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.
Eingaben
String
Sie können eine Zeichenfolge weiterleiten, die den Inhalt enthält, der auf die Zwischenablage festgelegt werden soll, an dieses Cmdlet.
Ausgaben
None
Dieses Cmdlet gibt keine Ausgabe zurück.
Hinweise
PowerShell enthält die folgenden Aliase für Set-Clipboard:
- Alle Plattformen:
scb
Unterstützung für dieses Cmdlet unter macOS wurde in der PowerShell 7.0.0-Version hinzugefügt.
