Udostępnij za pośrednictwem

Set-Clipboard

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

Ustawia bieżący wpis schowka systemu Windows.

Składnia

Set-Clipboard
   [-Append]
   [-AsHtml]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-Clipboard
   [-Value] <String[]>
   [-Append]
   [-AsHtml]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-Clipboard
   [-Append]
   -Path <String[]>
   [-AsHtml]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-Clipboard
   [-Append]
   -LiteralPath <String[]>
   [-AsHtml]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Opis

Polecenie Set-Clipboard cmdlet ustawia bieżący wpis schowka systemu Windows.

Przykłady

Przykład 1. Kopiowanie tekstu do schowka

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

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

W tym przykładzie zawartość określonego folderu jest kopiowana do schowka.

Set-Clipboard -Path "C:\Staging\"

Przykład 3. 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

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

-AsHtml

Wskazuje, że polecenie cmdlet renderuje zawartość jako kod HTML do schowka.

Type:SwitchParameter
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

-LiteralPath

Określa ścieżkę do elementu skopiowanego do schowka. W przeciwieństwie do ścieżki wartość LiterałuPath jest używana dokładnie tak, jak została zapisana. Znaki nie są interpretowane jako symbole wieloznaczne. Jeśli ścieżka zawiera znaki ucieczki, należy ująć ją w pojedynczy cudzysłów. Pojedyncze cudzysłowy informują program Windows PowerShell, aby nie interpretował żadnych znaków jako sekwencji ucieczki.

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

-Path

Określa ścieżkę do elementu skopiowanego do schowka. Dozwolone są symbole wieloznaczne.

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

-Value

Określa jako tablicę ciągów zawartość do skopiowania do schowka.

Type:String[]
Position:0
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 Windows PowerShell zawiera następujące aliasy dla programu Set-Clipboard:

  • scb

W rzadkich przypadkach, gdy używasz Set-Clipboard wiele razy w szybkim odstępie czasu, na przykład w pętli, schowek nie jest aktualizowany lub występuje błąd ExternalException . Może to być spowodowane próbą ustawienia schowka i jest ona nadal używana. Może to próbować uniknąć tego problemu, dodając Start-Sleep -Milliseconds 100 do pętli.