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 cmdlet 设置当前 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

指示 cmdlet 应将内容添加到剪贴板而不是替换它。默认情况下，cmdlet 会清除剪贴板中的当前内容，并将其设置为新内容。指定此参数后，cmdlet 会将换行符后的新内容追加到当前内容之后。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-AsHtml

指示 cmdlet 将内容作为 HTML 呈现到剪贴板。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Confirm

提示你在运行 cmdlet 之前进行确认。

类型:	SwitchParameter
别名:	cf
Position:	Named
默认值:	False
必需:	False
接受管道输入:	False
接受通配符:	False

-LiteralPath

指定复制到剪贴板的项的路径。与 Path 不同，LiteralPath 的值严格按照所写入的形式使用。不会将任何字符解释为通配符。如果路径包括转义符，请将其括在单引号中。单引号会告知 Windows PowerShell 不要将所有字符都解释为转义序列。

类型:	String[]
别名:	PSPath
Position:	Named
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-Path

指定复制到剪贴板的项的路径。允许使用通配符。

类型:	String[]
Position:	Named
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	True

-Value

以字符串数组的形式指定要复制到剪贴板的内容。

类型:	String[]
Position:	0
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-WhatIf

显示运行该 cmdlet 时会发生什么情况。 cmdlet 未运行。

类型:	SwitchParameter
别名:	wi
Position:	Named
默认值:	False
必需:	False
接受管道输入:	False
接受通配符:	False

输入

String

可以通过管道将包含要设置的剪贴板内容的字符串传递给此 cmdlet。

输出

None

此 cmdlet 不返回任何输出。

备注

Windows PowerShell 包含 Set-Clipboard 的以下别名：

scb

在极少数情况下，在快速连续使用 Set-Clipboard 多次（如在循环中）时，剪贴板不会更新，或者收到 ExternalException 错误。当你尝试设置剪贴板并且它仍在使用时，可能会导致此问题。可以尝试通过将 Start-Sleep -Milliseconds 100 添加到循环来避免此问题。

Get-Clipboard

通过