Set-Clipboard
Hiermee stelt u de inhoud van het klembord in.
Syntax
Default (Standaard)
Set-Clipboard
[-Value] <string[]>
[-Append]
[-PassThru]
[-AsOSC52]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
De Set-Clipboard cmdlet stelt de inhoud van het Klembord in.
Note
Op Linux moet het xclip-hulpprogramma zich in het systeempad bevinden. In macOS gebruikt deze cmdlet het hulpprogramma pbcopy.
Voorbeelden
Voorbeeld 1: Tekst naar het klembord kopiëren
Set-Clipboard -Value "This is a test string"
Voorbeeld 2: De inhoud van een bestand naar het klembord kopiëren
In dit voorbeeld wordt de inhoud van een bestand, een openbare ssh-sleutel, naar het klembord gelezen. Vervolgens kan de sleutel in een andere toepassing worden geplakt, zoals GitHub.
Get-Content C:\Users\user1\.ssh\id_ed25519.pub | Set-Clipboard
Voorbeeld 3: Tekst kopiëren naar het klembord van de lokale host via een externe SSH-sessie
Met de parameter AsOSC52 kunt u het klembord van de lokale computer instellen wanneer u via SSH verbinding maakt met een externe sessie.
Set-Clipboard -Value "This is a test string" -AsOSC52
Voorbeeld 4: De standaardwaarde van de parameter **AsOSC52** instellen
U kunt detecteren of u bent verbonden met een externe sessie via SSH door de waarde van de $Env:SSH_CLIENT of $Env:SSH_TTY omgevingsvariabelen te controleren. Als een van deze variabelen is ingesteld, bent u verbonden met een externe sessie via SSH. U kunt deze informatie gebruiken om de standaardwaarde van de AsOSC52-parameter in te stellen. Voeg een van de volgende regels toe aan uw PowerShell-profielscript.
$PSDefaultParameterValues['Set-Clipboard:AsOSC52'] = $Env:SSH_CLIENT
$PSDefaultParameterValues['Set-Clipboard:AsOSC52'] = $Env:SSH_TTY
Zie about_Parameters_Default_Values voor meer informatie.$PSDefaultParameterValues
Parameters
-Append
Geeft aan dat de cmdlet moet worden toegevoegd aan het klembord in plaats van deze te vervangen. De cmdlet wist standaard de huidige inhoud van het Klembord en stelt deze in op de nieuwe inhoud. Wanneer deze parameter is opgegeven, voegt de cmdlet de nieuwe inhoud toe na een nieuwe regel aan de huidige inhoud.
Parametereigenschappen
| Type: | SwitchParameter |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
-AsOSC52
Wanneer u via SSH verbinding maakt met een externe sessie, Set-Clipboard stelt u het klembord van de externe computer in, niet de lokale host. Wanneer u deze parameter gebruikt, Set-Clipboard gebruikt u de ESCAPE-reeks OSC52 ANSI om het klembord van de lokale computer in te stellen.
Deze functie werkt alleen als uw terminaltoepassing ondersteuning biedt voor de ESCAPE-reeks OSC52 ANSI. De Windows Terminal ondersteunt deze functie.
Deze parameter is toegevoegd in PowerShell 7.4.
Parametereigenschappen
| Type: | SwitchParameter |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
| Aliassen: | ToLocalhost |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
-Confirm
Voordat u de cmdlet uitvoert, vraagt het systeem om bevestiging.
Parametereigenschappen
| Type: | SwitchParameter |
| Default value: | False |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
| Aliassen: | Cf |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
-PassThru
Hiermee wordt een object geretourneerd dat het item aangeeft waarmee u werkt. Deze cmdlet genereert standaard geen uitvoer.
Parametereigenschappen
| Type: | SwitchParameter |
| Default value: | False |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
-Value
De tekenreekswaarden die aan het klembord moeten worden toegevoegd.
Parametereigenschappen
| Type: | String[] |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
(All)
| Position: | Named |
| Verplicht: | True |
| Waarde uit pijplijn: | True |
| Waarde uit pijplijn op eigenschapsnaam: | True |
| Waarde van resterende argumenten: | False |
-WhatIf
Toont wat er zou gebeuren wanneer de cmdlet wordt uitgevoerd. De cmdlet wordt niet uitgevoerd.
Parametereigenschappen
| Type: | SwitchParameter |
| Default value: | False |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
| Aliassen: | Wi |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
CommonParameters
Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.
Invoerwaarden
String
U kunt een tekenreeks met de inhoud doorsluisen die u wilt instellen op het Klembord op deze cmdlet.
Uitvoerwaarden
None
Deze cmdlet retourneert geen uitvoer.
Notities
PowerShell bevat de volgende aliassen voor Set-Clipboard:
- Alle platforms:
scb
Ondersteuning voor deze cmdlet in macOS is toegevoegd in de PowerShell 7.0.0-release.