Set-Clipboard
Beállítja a vágólap tartalmát.
Syntax
Default (Alapértelmezett)
Set-Clipboard
[-Value] <string[]>
[-Append]
[-PassThru]
[-AsOSC52]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
A Set-Clipboard parancsmag beállítja a vágólap tartalmát.
Megjegyzés:
Linuxon ehhez a parancsmaghoz a xclip segédprogramnak az elérési úton kell lennie. MacOS rendszeren ez a parancsmag a pbcopy segédprogramot használja.
Példák
1. példa: Szöveg másolása a vágólapra
Set-Clipboard -Value "This is a test string"
2. példa: Fájl tartalmának másolása a vágólapra
Ez a példa egy fájl, egy nyilvános ssh-kulcs tartalmát a vágólapra ássa. Ezután a kulcs beilleszthető egy másik alkalmazásba, például a GitHubba.
Get-Content C:\Users\user1\.ssh\id_ed25519.pub | Set-Clipboard
3. példa: Szöveg másolása a helyi gazdagép vágólapjára egy távoli SSH-munkameneten keresztül
Az AsOSC52 paraméter lehetővé teszi a helyi gép vágólapjának beállítását, amikor SSH-kapcsolaton keresztül csatlakozik egy távoli munkamenethez.
Set-Clipboard -Value "This is a test string" -AsOSC52
4. példa: Az **AsOSC52** paraméter alapértelmezett értékének beállítása
A $Env:SSH_CLIENT vagy $Env:SSH_TTY környezeti változók értékének ellenőrzésével észlelheti, hogy SSH-kapcsolaton keresztül csatlakozik-e távoli munkamenethez. Ha valamelyik változó be van állítva, akkor SSH-kapcsolaton keresztül csatlakozik egy távoli munkamenethez. Ezekkel az információkkal beállíthatja az AsOSC52 paraméter alapértelmezett értékét. Adja hozzá az alábbi sorok egyikét a PowerShell-profilszkriptjéhez.
$PSDefaultParameterValues['Set-Clipboard:AsOSC52'] = $Env:SSH_CLIENT
$PSDefaultParameterValues['Set-Clipboard:AsOSC52'] = $Env:SSH_TTY
A $PSDefaultParameterValuestovábbi információkért lásd: about_Parameters_Default_Values.
Paraméterek
-Append
Azt jelzi, hogya helyett a parancsmagnak hozzá kell adnia a vágólaphoz. Alapértelmezés szerint a parancsmag törli az aktuális tartalmat a vágólapról, és beállítja az új tartalomra. Ha ez a paraméter meg van adva, a parancsmag hozzáfűzi az új tartalmat egy új vonal után az aktuális tartalomhoz.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-AsOSC52
Ha SSH-kapcsolaton keresztül csatlakozik egy távoli munkamenethez, Set-Clipboard a távoli gép vágólapját állítja be, nem a helyi gazdagépet. Ha ezt a paramétert használja, Set-Clipboard az OSC52 ANSI feloldóütemezést használja a helyi gép vágólapjának beállításához.
A funkció működéséhez a terminálalkalmazásnak támogatnia kell az OSC52 ANSI-feloldási sorozatot. A Windows Terminál támogatja ezt a funkciót.
Ez a paraméter a PowerShell 7.4-ben lett hozzáadva.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | ToLocalhost |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-Confirm
Megerősítést kér a parancsmag futtatása előtt.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | False |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | Cf |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-PassThru
Egy objektumot ad vissza, amely azt az elemet jelöli, amellyel dolgozik. Ez a parancsmag alapértelmezés szerint nem hoz létre kimenetet.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | False |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-Value
A vágólapra felvenni kívánt sztringértékek.
Paramétertulajdonságok
| Típus: | String[] |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | True |
| Folyamatból származó érték: | True |
| Folyamatból származó érték tulajdonságnév alapján: | True |
| Fennmaradó argumentumokból származó érték: | False |
-WhatIf
Megjeleníti, mi történne, ha a parancsmag futna. A parancsprogram nem lett futtatva.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | False |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | Wi |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
CommonParameters
Ez a parancsmag a következő gyakori paramétereket támogatja: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction és -WarningVariable. További információért lásd about_CommonParameters.
Bevitelek
String
A tartalmat tartalmazó sztringet a parancsmag vágólapjára állíthatja.
Kimenetek
None
Ez a parancsmag nem ad vissza kimenetet.
Jegyzetek
A PowerShell a következő aliasokat tartalmazza Set-Clipboard:
- Minden platform:
scb
A macOS-en futó parancsmag támogatása a PowerShell 7.0.0 kiadásban lett hozzáadva.
