Freigeben über

Set-Clipboard

  • Referenz
Modul:
Microsoft.PowerShell.Management

Legt den aktuellen Windows-Zwischenablageeintrag fest.

Syntax

Set-Clipboard
   [-Append]
   [-AsHtml]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-Clipboard
   [-Value] <String[]>
   [-Append]
   [-AsHtml]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-Clipboard
   [-Append]
   -Path <String[]>
   [-AsHtml]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-Clipboard
   [-Append]
   -LiteralPath <String[]>
   [-AsHtml]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Beschreibung

Das Set-Clipboard Cmdlet legt den aktuellen Windows-Zwischenablageeintrag fest.

Beispiele

Beispiel 1: Kopieren von Text in die Zwischenablage

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

Beispiel 2: Kopieren des Inhalts eines Verzeichnisses in die Zwischenablage

In diesem Beispiel wird der Inhalt des angegebenen Ordners in die Zwischenablage kopiert.

Set-Clipboard -Path "C:\Staging\"

Beispiel 3: Kopieren des Inhalts einer Datei in die Zwischenablage

In diesem Beispiel wird der Inhalt einer Datei, eines öffentlichen SSH-Schlüssels, in die Zwischenablage übertragen. Anschließend kann der Schlüssel in eine andere Anwendung eingefügt werden, z. B. GitHub.

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

Parameter

-Append

Gibt an, dass das Cmdlet der Zwischenablage hinzugefügt werden soll, anstatt es zu ersetzen. Standardmäßig löscht das Cmdlet den aktuellen Inhalt aus der Zwischenablage und legt ihn auf den neuen Inhalt fest. Wenn dieser Parameter angegeben wird, fügt das Cmdlet den neuen Inhalt nach einer Neuen zeile an den aktuellen Inhalt an.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-AsHtml

Gibt an, dass das Cmdlet den Inhalt als HTML in der Zwischenablage rendert.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Confirm

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

Typ:SwitchParameter
Aliase:cf
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-LiteralPath

Gibt den Pfad zum Element an, das in die Zwischenablage kopiert wird. Im Gegensatz zu Path wird der Wert von LiteralPath genau wie geschrieben verwendet. Es werden keine Zeichen als Platzhalter interpretiert. Wenn der Pfad Escapezeichen enthält, müssen Sie ihn in einfache Anführungszeichen einschließen. Einfache Anführungszeichen veranlassen Windows PowerShell, Zeichen nicht als Escapesequenzen zu interpretieren.

Typ:String[]
Aliase:PSPath
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Path

Gibt den Pfad zum Element an, das in die Zwischenablage kopiert wird. Platzhalterzeichen sind zulässig.

Typ:String[]
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:True

-Value

Gibt als Zeichenfolgenarray den Inhalt an, der in die Zwischenablage kopiert werden soll.

Typ:String[]
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-WhatIf

Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Typ:SwitchParameter
Aliase:wi
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

String

Sie können eine Zeichenfolge weiterleiten, die den Inhalt enthält, der auf die Zwischenablage festgelegt werden soll, an dieses Cmdlet.

Ausgaben

None

Dieses Cmdlet gibt keine Ausgabe zurück.

Hinweise

Windows PowerShell enthält die folgenden Aliase für Set-Clipboard:

  • scb

In seltenen Fällen wird die Set-Clipboard Zwischenablage, z. B. in einer Schleife, häufig nacheinander verwendet, nicht aktualisiert, oder Sie erhalten einen ExternalException-Fehler . Dies kann verursacht werden, wenn Sie versuchen, die Zwischenablage festzulegen, und sie wird weiterhin verwendet. Dies kann versuchen, dieses Problem zu vermeiden, indem Sie der Schleife hinzufügen Start-Sleep -Milliseconds 100 .