Set-Clipboard
Anger innehållet i Urklipp.
Syntax
Default (Standard)
Set-Clipboard
[-Value] <string[]>
[-Append]
[-PassThru]
[-AsOSC52]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Cmdleten Set-Clipboard ställer in innehållet i urklipp.
Anmärkning
I Linux kräver den här cmdleten att verktyget xclip finns i sökvägen. I macOS använder den här cmdleten verktyget pbcopy.
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 datorn via en SSH-fjärrsession
Med parametern AsOSC52 kan du ange urklippet 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 eller $Env:SSH_TTY miljövariabler. 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 standardinställning rensar cmdleten det aktuella innehållet från Urklipp och ändrar 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.
Parameteregenskaper
| Typ: | SwitchParameter |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
(All)
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | False |
-AsOSC52
När du är ansluten till en fjärrsession via SSH anger Set-Clipboard urklippet för fjärrdatorn, inte den lokala datorn. När du använder den här parametern använder Set-Clipboard OSC52 ANSI-escape-sekvensen för att ställa in urklippet på 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ödjer den här funktionen.
Den här parametern lades till i PowerShell 7.4.
Parameteregenskaper
| Typ: | SwitchParameter |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
| Alias: | ToLocalhost |
Parameteruppsättningar
(All)
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | False |
-Confirm
Uppmanar dig att bekräfta innan du kör cmdleten.
Parameteregenskaper
| Typ: | SwitchParameter |
| Standardvärde: | False |
| Stöder jokertecken: | False |
| DontShow: | False |
| Alias: | jfr |
Parameteruppsättningar
(All)
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | False |
-PassThru
Returnerar ett objekt som representerar det objekt som du arbetar med. Som standard genererar den här cmdleten inga utdata.
Parameteregenskaper
| Typ: | SwitchParameter |
| Standardvärde: | False |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
(All)
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | False |
-Value
Strängvärdena som ska läggas till i Urklipp.
Parameteregenskaper
| Typ: | String[] |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
(All)
| Position: | Named |
| Obligatorisk: | True |
| Värde från pipeline: | True |
| Värde från pipeline efter egenskapsnamn: | True |
| Värde från återstående argument: | False |
-WhatIf
Visar vad som skulle hända om kommandot körs. Cmdleten körs inte.
Parameteregenskaper
| Typ: | SwitchParameter |
| Standardvärde: | False |
| Stöder jokertecken: | False |
| DontShow: | False |
| Alias: | Wi |
Parameteruppsättningar
(All)
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | False |
CommonParameters
Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.
Indata
String
Du kan skicka en sträng med det innehåll som ska kopieras 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.
