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

通过