Sdílet prostřednictvím

Set-Clipboard

  • Reference
Modul:
Microsoft.PowerShell.Management

Nastaví obsah schránky.

Syntaxe

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

Description

Rutina Set-Clipboard nastaví obsah schránky.

Poznámka:

V Linuxu xclip tato rutina vyžaduje, aby byl nástroj v cestě. V systému macOS tato rutina pbcopy používá nástroj.

Příklady

Příklad 1: Zkopírování textu do schránky

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

Příklad 2: Zkopírování obsahu souboru do schránky

Tento příklad předá obsah souboru, veřejného klíče ssh, do schránky. Pak je možné klíč vložit do jiné aplikace, jako je GitHub.

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

Příklad 3: Zkopírování textu do schránky místního hostitele přes vzdálenou relaci SSH

Parametr AsOSC52 umožňuje nastavit schránku místního počítače při připojení ke vzdálené relaci přes SSH.

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

Příklad 4: Nastavení výchozí hodnoty parametru **AsOSC52**

Pokud jste připojení ke vzdálené relaci přes SSH, můžete zjistit kontrolou hodnoty proměnných $env:SSH_CLIENT prostředí nebo $env:SSH_TTY proměnné prostředí. Pokud jsou některé z těchto proměnných nastavené, pak jste připojení ke vzdálené relaci přes SSH. Tyto informace můžete použít k nastavení výchozí hodnoty parametru AsOSC52 . Do skriptu profilu PowerShellu přidejte jeden z následujících řádků.

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

Další informace o $PSDefaultParameterValuesnástroji najdete v tématu about_Parameters_Default_Values.

Parametry

-Append

Označuje, že rutina by měla místo nahrazení přidat do schránky. Ve výchozím nastavení rutina vymaže aktuální obsah ze schránky a nastaví ho na nový obsah. Po zadání tohoto parametru rutina připojí nový obsah za nový řádek k aktuálnímu obsahu.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-AsOSC52

Při připojení ke vzdálené relaci přes SSH Set-Clipboard nastaví schránku vzdáleného počítače, nikoli místního hostitele. Pokud použijete tento parametr, Set-Clipboard použije řídicí sekvenci ANSI OSC52 k nastavení schránky místního počítače.

Aby tato funkce fungovala, musí vaše terminálová aplikace podporovat řídicí sekvenci ANSI OSC52. Tato funkce podporuje Terminál Windows.

Tento parametr byl přidán v PowerShellu 7.4.

Typ:SwitchParameter
Aliasy:ToLocalhost
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Confirm

Před spuštěním rutiny zobrazí výzvu k potvrzení.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-PassThru

Vrátí objekt představující položku, se kterou pracujete. Ve výchozím nastavení tato rutina negeneruje žádný výstup.

Typ:SwitchParameter
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Value

Řetězcové hodnoty, které se mají přidat do schránky.

Typ:String[]
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-WhatIf

Zobrazuje, co by se stalo při spuštění rutiny. Rutina se nespustí.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

Vstupy

String

Řetězec obsahující obsah, který chcete nastavit do schránky na tuto rutinu, můžete pipetovat.

Výstupy

None

Tato rutina nevrátí žádný výstup.

Poznámky

PowerShell obsahuje následující aliasy pro Set-Clipboard:

  • Všechny platformy:
    • scb

Podpora této rutiny v systému macOS byla přidána ve verzi PowerShellu 7.0.0.