Set-Clipboard
設定目前的 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>]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 會將新內容附加至目前的內容之後。
| 類型: | 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 |
輸入
您可以使用管線將包含要設定為剪貼簿內容的字串傳送至此 Cmdlet。
輸出
None
此 Cmdlet 不會傳回任何輸出。
備註
Windows PowerShell 包含下列的 Set-Clipboard別名：
scb
在罕見的情況下，在快速連續使用 Set-Clipboard 多次時，例如在迴圈中，剪貼簿不會更新，或您收到 ExternalException 錯誤。 當您嘗試設定剪貼簿且仍在使用中時，可能會造成此狀況。 這可以嘗試藉由將 新增 Start-Sleep -Milliseconds 100 至 迴圈來避免這個問題。
