Set-Clipboard

  • 參考
模組:
Microsoft.PowerShell.Management

設定目前的 Windows 剪貼簿專案。

Syntax

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>]

Description

Cmdlet 會 Set-Clipboard 設定目前的 Windows 剪貼簿專案。

範例

範例 1：將文字複製到剪貼簿

Set-Clipboard -Value "This is a test string"

範例 2：將目錄的內容複製到剪貼簿

本範例會將指定資料夾的內容複製到剪貼簿。

Set-Clipboard -Path "C:\Staging\"

範例 3：將檔案的內容複製到剪貼簿

此範例會將檔案的內容管線傳送至剪貼簿，也就是公鑰。 然後，金鑰可以貼到另一個應用程式，例如 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 至 迴圈來避免這個問題。