Udostępnij za pośrednictwem

Set-Clipboard

  • Odwołanie
Moduł:
Microsoft.PowerShell.Management

Ustawia zawartość schowka.

Składnia

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

Opis

Polecenie Set-Clipboard cmdlet ustawia zawartość schowka.

Uwaga

W systemie Linux to polecenie cmdlet wymaga xclip , aby narzędzie było w ścieżce.

Przykłady

Przykład 1. Kopiowanie tekstu do schowka

Set-Clipboard -Value "This is a test string"

Przykład 2. Kopiowanie zawartości pliku do schowka

W tym przykładzie zawartość pliku , publicznego klucza SSH, jest potokiem do schowka. Następnie klucz można wkleić do innej aplikacji, takiej jak GitHub.

Get-Content C:\Users\user1\.ssh\id_ed25519.pub | Set-Clipboard

Przykład 3. Kopiowanie tekstu do schowka hosta lokalnego za pośrednictwem sesji zdalnej SSH

Parametr AsOSC52 umożliwia ustawienie schowka maszyny lokalnej po nawiązaniu połączenia z sesją zdalną za pośrednictwem protokołu SSH.

Set-Clipboard -Value "This is a test string" -AsOSC52

Przykład 4. Ustawienie wartości domyślnej **AsOSC52** parametru

Możesz wykryć, czy masz połączenie z sesją zdalną za pośrednictwem protokołu SSH, sprawdzając wartość $env:SSH_CLIENT zmiennych środowiskowych lub $env:SSH_TTY . Jeśli którakolwiek z tych zmiennych jest ustawiona, masz połączenie z sesją zdalną za pośrednictwem protokołu SSH. Te informacje umożliwiają ustawienie wartości domyślnej parametru AsOSC52 . Dodaj jeden z następujących wierszy do skryptu profilu programu PowerShell.

$PSDefaultParameterValues['Set-Clipboard:AsOSC52'] = $env:SSH_CLIENT
$PSDefaultParameterValues['Set-Clipboard:AsOSC52'] = $env:SSH_TTY

Aby uzyskać więcej informacji na temat $PSDefaultParameterValuesprogramu , zobacz about_Parameters_Default_Values.

Parametry

-Append

Wskazuje, że polecenie cmdlet powinno zostać dodane do schowka zamiast go zastąpić. Domyślnie polecenie cmdlet czyści bieżącą zawartość ze schowka i ustawia ją na nową zawartość. Po określeniu tego parametru polecenie cmdlet dołącza nową zawartość po nowym wierszu do bieżącej zawartości.

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

-AsOSC52

Po nawiązaniu połączenia z sesją zdalną za pośrednictwem protokołu SSH Set-Clipboard ustawia schowek maszyny zdalnej, a nie hosta lokalnego. W przypadku korzystania z tego parametru Set-Clipboard używa sekwencji ucieczki ANSI OSC52, aby ustawić schowek komputera lokalnego.

Aby ta funkcja działała, aplikacja terminalowa musi obsługiwać sekwencję ucieczki ANSI OSC52. Terminal Windows obsługuje tę funkcję.

Ten parametr został dodany w programie PowerShell 7.4.

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

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

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

-PassThru

Zwraca obiekt reprezentujący element, z którym pracujesz. Domyślnie to polecenie cmdlet nie generuje żadnych danych wyjściowych.

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

-Value

Wartości ciągu, które mają zostać dodane do schowka.

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

-WhatIf

Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie jest uruchamiane.

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

Dane wejściowe

String

Możesz potokować ciąg zawierający zawartość, aby ustawić schowek na to polecenie cmdlet.

Dane wyjściowe

None

To polecenie cmdlet nie zwraca żadnych danych wyjściowych.

Uwagi

Program PowerShell zawiera następujące aliasy dla programu Set-Clipboard:

  • Wszystkie platformy:
    • scb