Поделиться через


Get-Clipboard

Возвращает текущую запись буфера обмена Windows.

Синтаксис

Default (По умолчанию)

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

Описание

Командлет Get-Clipboard получает текущую запись буфера обмена Windows. Несколько строк текста возвращаются в виде массива строк, аналогичных Get-Content.

Примеры

Пример 1. Получение содержимого буфера обмена

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

Пример 2. Получение содержимого буфера обмена в определенном формате

В этом примере мы скопировали файлы в буфер обмена в проводнике Windows, выбрав их и нажав клавиши CTRL-C. С помощью следующей команды можно получить доступ к содержимому буфера обмена в виде списка файлов:

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

Параметры

-Format

Указывает тип или формат буфера обмена. Допустимые значения для этого параметра:

  • Текст
  • ФайлDropList (ФайлDropList)
  • Изображение
  • Аудио

Свойства параметров

Тип:ClipboardFormat
Default value:None
Допустимые значения:Text, FileDropList, Image, Audio
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Raw

Возвращает все данные буфера обмена. Многострочный текст возвращается как одна многострочная строка, а не массив строк.

Свойства параметров

Тип:SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-TextFormatType

Указывает тип формата текстовых данных буфера обмена. Допустимые значения для этого параметра:

  • Текст
  • ЮникодТекст
  • Ртф
  • Html
  • ЗапятаяSeparatedValue

Свойства параметров

Тип:TextDataFormat
Default value:None
Допустимые значения:Text, UnicodeText, Rtf, Html, CommaSeparatedValue
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

CommonParameters

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.

Входные данные

None

Невозможно передать объекты в этот командлет.

Выходные данные

String

По умолчанию этот командлет возвращает содержимое в виде массива строк, по одному на строку. При использовании необработанного параметра возвращается одна строка, содержащая каждую строку в файле.

FileInfo

Stream

Image

Примечания

Windows PowerShell включает следующие псевдонимы для Get-Clipboard:

  • gcb