Freigeben über


Get-Clipboard

Ruft den aktuellen Windows-Zwischenablageeintrag ab.

Syntax

Default (Standard)

Get-Clipboard
    [-Format <ClipboardFormat>]
    [-TextFormatType <TextDataFormat>]
    [-Raw]
    [<CommonParameters>]

Beschreibung

Das Cmdlet Get-Clipboard ruft den aktuellen Windows-Zwischenablageeintrag ab. Mehrere Textzeilen werden als Array von Zeichenfolgen zurückgegeben, die Get-Contentähneln.

Beispiele

Beispiel 1: Abrufen des Inhalts der Zwischenablage

Set-Clipboard -Value 'hello world'
Get-Clipboard
hello world

Beispiel 2: Abrufen des Inhalts der Zwischenablage in einem bestimmten Format

In diesem Beispiel haben wir Dateien in die Zwischenablage im Windows-Explorer kopiert, indem wir sie auswählen und STRG-C-drücken. Mit dem folgenden Befehl können Sie als Dateiliste auf den Inhalt der Zwischenablage zugreifen:

Get-Clipboard -Format FileDropList
    Directory: C:\Git\PS-Docs\PowerShell-Docs\wmf

Mode                LastWriteTime         Length Name
----                -------------         ------ ----
-a----         5/7/2019   1:11 PM          10010 TOC.yml
-a----       11/18/2016  10:10 AM             53 md.style
-a----         5/6/2019   9:32 AM           4177 overview.md
-a----        6/28/2018   2:28 PM            345 README.md

Parameter

-Format

Gibt den Typ oder das Format der Zwischenablage an. Die zulässigen Werte für diesen Parameter sind:

  • Text
  • FileDropList
  • Abbildung
  • Audio

Parametereigenschaften

Typ:ClipboardFormat
Standardwert:None
Zulässige Werte:Text, FileDropList, Image, Audio
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Raw

Ruft den gesamten Inhalt der Zwischenablage ab. Mehrzeilentext wird als einzelne mehrteilige Zeichenfolge und nicht als Array von Zeichenfolgen zurückgegeben.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-TextFormatType

Gibt den Textdatenformattyp der Zwischenablage an. Die zulässigen Werte für diesen Parameter sind:

  • Text
  • UnicodeText
  • Rtf
  • HTML
  • KommaSeparatedValue

Parametereigenschaften

Typ:TextDataFormat
Standardwert:None
Zulässige Werte:Text, UnicodeText, Rtf, Html, CommaSeparatedValue
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.

Eingaben

None

Sie können keine Objekte an dieses Cmdlet weiterleiten.

Ausgaben

String

Standardmäßig gibt dieses Cmdlet den Inhalt als Array von Zeichenfolgen zurück, eine pro Zeile. Wenn Sie den Parameter Raw verwenden, wird eine einzelne Zeichenfolge zurückgegeben, die jede Zeile in der Datei enthält.

FileInfo

Stream

Image

Hinweise

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

  • gcb