Dela via

Set-Clipboard

  • Referens
Modul:
Microsoft.PowerShell.Management

Anger innehållet i Urklipp.

Syntax

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

Description

Cmdleten Set-Clipboard anger innehållet i Urklipp.

Kommentar

I Linux kräver den här cmdleten xclip att verktyget finns i sökvägen. I macOS använder den här cmdleten pbcopy verktyget.

Exempel

Exempel 1: Kopiera text till Urklipp

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

Exempel 2: Kopiera innehållet i en fil till Urklipp

I det här exemplet skickas innehållet i en fil, en offentlig ssh-nyckel, till Urklipp. Sedan kan nyckeln klistras in i ett annat program, till exempel GitHub.

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

Exempel 3: Kopiera text till Urklipp för den lokala värden via en SSH-fjärrsession

Med parametern AsOSC52 kan du ange Urklipp för den lokala datorn när du är ansluten till en fjärrsession via SSH.

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

Exempel 4: Ange standardvärdet för parametern **AsOSC52**

Du kan identifiera om du är ansluten till en fjärrsession via SSH genom att kontrollera värdet för $env:SSH_CLIENT miljövariablerna eller $env:SSH_TTY . Om någon av dessa variabler har angetts är du ansluten till en fjärrsession via SSH. Du kan använda den här informationen för att ange standardvärdet för parametern AsOSC52 . Lägg till någon av följande rader i PowerShell-profilskriptet.

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

Mer information om $PSDefaultParameterValuesfinns i about_Parameters_Default_Values.

Parametrar

-Append

Anger att cmdleten ska läggas till i Urklipp i stället för att ersätta den. Som standard rensar cmdleten det aktuella innehållet från Urklipp och anger det till det nya innehållet. När den här parametern har angetts lägger cmdleten till det nya innehållet efter en ny rad i det aktuella innehållet.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-AsOSC52

När du är ansluten till en fjärrsession via SSH anger Set-Clipboard du Urklipp för fjärrdatorn, inte den lokala värden. När du använder den här parametern Set-Clipboard använder du OSC52 ANSI-escape-sekvensen för att ange Urklipp för den lokala datorn.

För att den här funktionen ska fungera måste terminalprogrammet ha stöd för OSC52 ANSI-escape-sekvensen. Windows-terminalen stöder den här funktionen.

Den här parametern lades till i PowerShell 7.4.

Typ:SwitchParameter
Alias:ToLocalhost
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

Typ:SwitchParameter
Alias:cf
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-PassThru

Returnerar ett objekt som representerar det objekt som du arbetar med. Som standard genererar den här cmdleten inga utdata.

Typ:SwitchParameter
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Value

Strängvärdena som ska läggas till i Urklipp.

Typ:String[]
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-WhatIf

Visar vad som skulle hända om cmdleten kördes. Cmdleten körs inte.

Typ:SwitchParameter
Alias:wi
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

Indata

String

Du kan skicka en sträng som innehåller innehållet som ska anges till Urklipp till den här cmdleten.

Utdata

None

Den här cmdleten returnerar inga utdata.

Kommentarer

PowerShell innehåller följande alias för Set-Clipboard:

  • Alla plattformar:
    • scb

Stöd för den här cmdleten på macOS har lagts till i PowerShell 7.0.0-versionen.