Sdílet prostřednictvím

Set-Clipboard

  • Reference
Modul:
Microsoft.PowerShell.Management

Nastaví aktuální položku schránky Systému Windows.

Syntaxe

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>]

Description

Rutina Set-Clipboard nastaví aktuální položku schránky Windows.

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 adresáře do schránky

Tento příklad zkopíruje obsah zadané složky do schránky.

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

Příklad 3: 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

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

-AsHtml

Označuje, že rutina vykreslí obsah jako HTML do schránky.

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

-LiteralPath

Určuje cestu k položce, která se zkopíruje do schránky. Na rozdíl od cesty se hodnota LiteralPath používá přesně tak, jak je napsaná. Žádné znaky nejsou interpretovány jako zástupné znaky. Pokud cesta obsahuje řídicí znaky, uzavřete ji do jednoduchých uvozovek. Jednoduché uvozovky říkají prostředí Windows PowerShell, aby nepřekládaly žádné znaky jako řídicí sekvence.

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

-Path

Určuje cestu k položce, která se zkopíruje do schránky. Jsou povoleny zástupné znaky.

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

-Value

Určuje jako pole řetězců obsah, který se má zkopírovat do schránky.

Typ:String[]
Position:0
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

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

  • scb

Ve výjimečných případech se při použití Set-Clipboard mnohokrát v rychlém sledu, například ve smyčce, schránka neaktualizuje nebo se zobrazí chyba ExternalException . To může být způsobeno tím, že se pokusíte nastavit schránku a stále se používá. To se může pokusit vyhnout tomuto problému přidáním Start-Sleep -Milliseconds 100 do smyčky.