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. W systemie macOS to polecenie cmdlet używa pbcopy narzędzia .

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.

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych: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.

Typ:SwitchParameter
Aliasy:ToLocalhost
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Domyślna wartość:False
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-PassThru

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

Typ:SwitchParameter
Position:Named
Domyślna wartość:False
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Value

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

Typ:String[]
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-WhatIf

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

Typ:SwitchParameter
Aliasy:wi
Position:Named
Domyślna wartość:False
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych: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

Obsługa tego polecenia cmdlet w systemie macOS została dodana w wersji programu PowerShell 7.0.0.