Set-Clipboard
Задает текущую запись буфера обмена Windows.
Синтаксис
String (По умолчанию)
Set-Clipboard
[-Append]
[-AsHtml]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Value
Set-Clipboard
[-Value] <String[]>
[-Append]
[-AsHtml]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Path
Set-Clipboard
-Path <String[]>
[-Append]
[-AsHtml]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
LiteralPath
Set-Clipboard
-LiteralPath <String[]>
[-Append]
[-AsHtml]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Описание
Командлет Set-Clipboard задает текущую запись буфера обмена Windows.
Примеры
Пример 1. Копирование текста в буфер обмена
Set-Clipboard -Value "This is a test string"
Пример 2. Копирование содержимого каталога в буфер обмена
В этом примере копируется содержимое указанной папки в буфер обмена.
Set-Clipboard -Path "C:\Staging\"
Пример 3. Копирование содержимого файла в буфер обмена
В этом примере содержимое файла, открытого ключа SSH, передается в буфер обмена. Затем ключ можно вставить в другое приложение, например GitHub.
Get-Content C:\Users\user1\.ssh\id_ed25519.pub | Set-Clipboard
Параметры
-Append
Указывает, что командлет должен добавляться в буфер обмена вместо замены. По умолчанию командлет очищает текущее содержимое из буфера обмена и задает его новому содержимому. При указании этого параметра командлет добавляет новое содержимое после новой линии к текущему содержимому.
Свойства параметров
| Тип: | SwitchParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-AsHtml
Указывает, что командлет отображает содержимое в виде HTML в буфер обмена.
Свойства параметров
| Тип: | SwitchParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Confirm
Запрашивает подтверждение перед запуском cmdlet.
Свойства параметров
| Тип: | SwitchParameter |
| Default value: | False |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | cf |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-LiteralPath
Указывает путь к элементу, скопированный в буфер обмена. В отличие от пути, значение LiteralPath используется точно так же, как она написана. Никакие символы не интерпретируются как подстановочные знаки. Если путь содержит escape-символы, заключите его в одинарные кавычки. Одинарные кавычки говорят Windows PowerShell не интерпретировать какие-либо символы как escape-последовательности.
Свойства параметров
| Тип: | String[] |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | PSPath |
Наборы параметров
LiteralPath
| Position: | Named |
| Обязательно: | True |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
-Path
Указывает путь к элементу, скопированный в буфер обмена. Разрешено использование подстановочных символов.
Свойства параметров
| Тип: | String[] |
| Default value: | None |
| Поддерживаются подстановочные знаки: | True |
| DontShow: | False |
Наборы параметров
Path
| Position: | Named |
| Обязательно: | True |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
-Value
Указывает в виде строкового массива содержимое для копирования в буфер обмена.
Свойства параметров
| Тип: | String[] |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
Value
| Position: | 0 |
| Обязательно: | True |
| Значение из конвейера: | True |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
-WhatIf
Показывает, что произойдет, если командлет будет запущен. Командлет не выполняется.
Свойства параметров
| Тип: | SwitchParameter |
| Default value: | False |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | wi |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
CommonParameters
Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.
Входные данные
String
Можно передать строку, содержащую содержимое, заданное в буфер обмена для этого командлета.
Выходные данные
None
Этот командлет не возвращает выходные данные.
Примечания
Windows PowerShell включает следующие псевдонимы для Set-Clipboard:
scb
В редких случаях при использовании Set-Clipboard много раз в быстром последовательности, например в цикле, буфер обмена не обновляется или возникает ошибка ExternalException. Это может быть вызвано при попытке установить буфер обмена, и он по-прежнему используется. Это может попытаться избежать этой проблемы, добавив Start-Sleep -Milliseconds 100 в цикл.
