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.