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 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 |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-AsHtml
指示 cmdlet 将内容呈现为 HTML 到剪贴板。
参数属性
| 类型: | SwitchParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-Confirm
在运行 cmdlet 之前，提示你进行确认。
参数属性
| 类型: | SwitchParameter |
| 默认值: | False |
| 支持通配符: | False |
| 不显示: | False |
| 别名: | cf |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-LiteralPath
指定复制到剪贴板的项的路径。 与 Path不同，LiteralPath 的值与写入时完全相同。 不会将任何字符解释为通配符。 如果路径包含转义字符，请将它括在单引号中。 单引号告知 Windows PowerShell 不要将任何字符解释为转义序列。
参数属性
| 类型: | String[] |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
| 别名: | PSPath |
参数集
LiteralPath
| Position: | Named |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | True |
| 来自剩余参数的值: | False |
-Path
指定复制到剪贴板的项的路径。 允许使用通配符。
参数属性
| 类型: | String[] |
| 默认值: | None |
| 支持通配符: | True |
| 不显示: | False |
参数集
Path
| Position: | Named |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | True |
| 来自剩余参数的值: | False |
-Value
指定要复制到剪贴板的内容，作为字符串数组。
参数属性
| 类型: | String[] |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
Value
| Position: | 0 |
| 必需: | True |
| 来自管道的值: | True |
| 来自管道的值（按属性名称）: | True |
| 来自剩余参数的值: | False |
-WhatIf
显示 cmdlet 运行时会发生什么情况。 cmdlet 未能运行。
参数属性
| 类型: | SwitchParameter |
| 默认值: | False |
| 支持通配符: | False |
| 不显示: | False |
| 别名: | 无线 |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
CommonParameters
此 cmdlet 支持通用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息，请参阅 about_CommonParameters。
输入
String
可以通过管道将包含要设置的剪贴板内容的字符串传递给此 cmdlet。
输出
None
此 cmdlet 不返回任何输出。
备注
Windows PowerShell 为 Set-Clipboard提供以下别名：
scb
在极少数情况下，在快速连续多次使用 Set-Clipboard（如循环中）时，剪贴板不会更新或收到 ExternalException 错误。 当你尝试设置剪贴板并且它仍在使用时，可能会导致此问题。 这可以通过向循环添加 Start-Sleep -Milliseconds 100 来尝试避免此问题。
