Freigeben über

Set-Clipboard

  • Referenz
Modul:
Microsoft.PowerShell.Management

Legt den Inhalt der Zwischenablage fest.

Syntax

Set-Clipboard
   [-Value] <string[]>
   [-Append]
   [-PassThru]
   [-AsOSC52]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Beschreibung

Das Set-Clipboard Cmdlet legt den Inhalt der Zwischenablage fest.

Hinweis

Unter Linux muss das xclip Hilfsprogramm für dieses Cmdlet im Pfad sein. Unter macOS verwendet dieses Cmdlet das pbcopy Hilfsprogramm.

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 Parameter AsOSC52 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 Variablen 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 $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.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-AsOSC52

Wenn eine Verbindung mit einer Remotesitzung über SSH hergestellt wird, Set-Clipboard wird die Zwischenablage des Remotecomputers und nicht des lokalen Hosts festgelegt. Wenn Sie diesen Parameter verwenden, wird die OSC52 ANSI-Escapesequenz verwendet, Set-Clipboard um die Zwischenablage des lokalen Computers festzulegen.

Damit dieses Feature funktioniert, muss Ihre Terminalanwendung die ANSI-Escapesequenz OSC52 unterstützen. Die Windows-Terminal unterstützt dieses Feature.

Dieser Parameter wurde in PowerShell 7.4 hinzugefügt.

Typ:SwitchParameter
Aliase:ToLocalhost
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Confirm

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

Typ:SwitchParameter
Aliase:cf
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-PassThru

Gibt ein Objekt zurück, das das Element darstellt, mit dem Sie arbeiten. Standardmäßig wird von diesem Cmdlet keine Ausgabe generiert.

Typ:SwitchParameter
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Value

Die Zeichenfolgenwerte, die der Zwischenablage hinzugefügt werden sollen.

Typ:String[]
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-WhatIf

Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Typ:SwitchParameter
Aliase:wi
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

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.