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