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.

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.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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, Set-Clipboard legt die OSC52 ANSI-Escapesequenz die Zwischenablage des lokalen Computers fest.

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.

Type:SwitchParameter
Aliases:ToLocalhost
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PassThru

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

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Value

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

Type:String[]
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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