Set-Clipboard
Задает содержимое буфера обмена.
Синтаксис
Set-Clipboard
[-Value] <string[]>
[-Append]
[-PassThru]
[-AsOSC52]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Описание
Командлет Set-Clipboard
задает содержимое буфера обмена.
Примечание.
В Linux этот командлет требует xclip
, чтобы программа была в пути.
Примеры
Пример 1. Копирование текста в буфер обмена
Set-Clipboard -Value "This is a test string"
Пример 2. Копирование содержимого файла в буфер обмена
В этом примере содержимое файла, открытого ключа SSH, передается в буфер обмена. Затем ключ можно вставить в другое приложение, например GitHub.
Get-Content C:\Users\user1\.ssh\id_ed25519.pub | Set-Clipboard
Пример 3. Копирование текста в буфер обмена локального узла через удаленный сеанс SSH
Параметр AsOSC52 позволяет задать буфер обмена локального компьютера при подключении к удаленному сеансу через SSH.
Set-Clipboard -Value "This is a test string" -AsOSC52
Пример 4. Установка значения по умолчанию параметра **AsOSC52**
Если вы подключены к удаленному сеансу через SSH, проверка значение $env:SSH_CLIENT
переменных среды или $env:SSH_TTY
переменных среды. Если заданы какие-либо из этих переменных, вы подключаетесь к удаленному сеансу через SSH. Эти сведения можно использовать для задания значения по умолчанию параметра AsOSC52 . Добавьте одну из следующих строк в скрипт профиля PowerShell.
$PSDefaultParameterValues['Set-Clipboard:AsOSC52'] = $env:SSH_CLIENT
$PSDefaultParameterValues['Set-Clipboard:AsOSC52'] = $env:SSH_TTY
Дополнительные сведения см. в $PSDefaultParameterValues
about_Parameters_Default_Values.
Параметры
-Append
Указывает, что командлет должен добавляться в буфер обмена вместо замены. По умолчанию командлет очищает текущее содержимое из буфера обмена и задает его новому содержимому. При указании этого параметра командлет добавляет новое содержимое после новой линии к текущему содержимому.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AsOSC52
При подключении к удаленному сеансу через SSH Set-Clipboard
задает буфер обмена удаленного компьютера, а не локальный узел. При использовании этого параметра Set-Clipboard
escape-последовательность OSC52 ANSI для установки буфера обмена локального компьютера.
Чтобы эта функция работала, приложение терминала должно поддерживать escape-последовательность ANSI OSC52. Терминал Windows поддерживает эту функцию.
Этот параметр добавлен в PowerShell 7.4.
Type: | SwitchParameter |
Aliases: | ToLocalhost |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
Запрос подтверждения перед выполнением командлета.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PassThru
Возвращает объект, представляющий элемент, с которым вы работаете. По умолчанию этот командлет не создает выходные данные.
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Value
Строковые значения, которые необходимо добавить в буфер обмена.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-WhatIf
Показывает, что произойдет при запуске командлета. Командлет не выполняется.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Входные данные
Можно передать строку, содержащую содержимое, заданное в буфер обмена для этого командлета.
Выходные данные
None
Этот командлет не возвращает выходные данные.
Примечания
PowerShell включает следующие псевдонимы для Set-Clipboard
:
- Все платформы:
scb
Связанные ссылки
PowerShell
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по