Set-Clipboard
Ustawia zawartość schowka.
Składnia
Default (Domyślna)
Set-Clipboard
[-Value] <string[]>
[-Append]
[-PassThru]
[-AsOSC52]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Opis
Polecenie cmdlet Set-Clipboard ustawia zawartość schowka.
Uwaga / Notatka
W systemie Linux to polecenie cmdlet wymaga, aby narzędzie xclip było w ścieżce. W systemie macOS to polecenie cmdlet używa narzędzia pbcopy.
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 komputera lokalnego podczas nawiązywania 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 lub $Env:SSH_TTY zmiennych środowiskowych. 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 $PSDefaultParameterValues, 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.
Właściwości parametru
| Typ: | SwitchParameter |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowy: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | 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. Jeśli używasz tego parametru, Set-Clipboard używa sekwencji ucieczki ANSI OSC52 w celu ustawienia schowka komputera lokalnego.
Aby ta funkcja działała, aplikacja terminalowa musi obsługiwać sekwencję ucieczki ANSI OSC52. Terminal systemu Windows obsługuje tę funkcję.
Ten parametr został dodany w programie PowerShell 7.4.
Właściwości parametru
| Typ: | SwitchParameter |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
| Aliasy: | ToLocalhost |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowy: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-Confirm
Prosi o potwierdzenie przed uruchomieniem cmdletu.
Właściwości parametru
| Typ: | SwitchParameter |
| Domyślna wartość: | False |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
| Aliasy: | por |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowy: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-PassThru
Zwraca obiekt reprezentujący element, z którym pracujesz. Domyślnie to polecenie cmdlet nie generuje żadnych danych wyjściowych.
Właściwości parametru
| Typ: | SwitchParameter |
| Domyślna wartość: | False |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowy: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-Value
Wartości ciągu, które mają zostać dodane do schowka.
Właściwości parametru
| Typ: | String[] |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowy: | True |
| Wartość z potoku: | True |
| Wartość z potoku według nazwy właściwości: | True |
| Wartość z pozostałych argumentów: | False |
-WhatIf
Pokazuje, co się stanie, jeśli polecenie cmdlet zostanie uruchomione. Cmdlet nie został uruchomiony.
Właściwości parametru
| Typ: | SwitchParameter |
| Domyślna wartość: | False |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
| Aliasy: | Wi |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowy: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
CommonParameters
To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.
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 Set-Clipboard:
- Wszystkie platformy:
scb
Obsługa tego polecenia cmdlet w systemie macOS została dodana w wersji programu PowerShell 7.0.0.
