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 会将换行符后的新内容追加到当前内容之后。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-AsHtml

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-LiteralPath

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

Type:String[]
Aliases:PSPath
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Path

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

Type:String[]
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:True

-Value

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

Type:String[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

输入

String

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

输出

None

此 cmdlet 不返回任何输出。

备注

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

  • scb

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