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

Set-Clipboard

  • Ссылка
Модуль:
Microsoft.PowerShell.Management

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

Синтаксис

Set-Clipboard
   [-Append]
   [-AsHtml]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-Clipboard
   [-Value] <String[]>
   [-Append]
   [-AsHtml]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-Clipboard
   [-Append]
   -Path <String[]>
   [-AsHtml]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-Clipboard
   [-Append]
   -LiteralPath <String[]>
   [-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
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-AsHtml

Указывает, что командлет отображает содержимое в виде HTML в буфер обмена.

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Confirm

Запрашивает подтверждение перед запуском командлета.

Тип:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-LiteralPath

Указывает путь к элементу, скопированный в буфер обмена. В отличие от пути, значение LiteralPath используется точно так же, как она написана. Символы не интерпретируются как подстановочные знаки. Если путь содержит escape-символы, заключите его в одинарные кавычки. Одинарные кавычки говорят Windows PowerShell не интерпретировать какие-либо символы как escape-последовательности.

Тип:String[]
Aliases:PSPath
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-Path

Указывает путь к элементу, скопированный в буфер обмена. Разрешены подстановочные знаки.

Тип:String[]
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:True

-Value

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

Тип:String[]
Position:0
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-WhatIf

Показывает, что произойдет, если командлет выполняется. Командлет не выполняется.

Тип:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

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

String

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

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

None

Этот командлет не возвращает выходные данные.

Примечания

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

  • scb

В редких случаях при использовании Set-Clipboard много раз в быстром последовательности, например в цикле, буфер обмена не обновляется или возникает ошибка ExternalException. Это может быть вызвано при попытке установить буфер обмена, и он по-прежнему используется. Это может попытаться избежать этой проблемы, добавив Start-Sleep -Milliseconds 100 в цикл.