Set-Clipboard

模組:

Microsoft.PowerShell.Management

設定剪貼簿的內容。

語法

Set-Clipboard
   [-Value] <string[]>
   [-Append]
   [-PassThru]
   [-AsOSC52]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Cmdlet 會 Set-Clipboard 設定剪貼簿的內容。

注意

在 Linux 上，此 Cmdlet 需要 xclip 公用程式位於路徑中。 在macOS上，此 Cmdlet 會使用 pbcopy 公用程式。

範例

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

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

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

此範例會將檔案的內容管線傳送至剪貼簿，也就是公鑰。 然後，金鑰可以貼到另一個應用程式，例如 GitHub。

Get-Content C:\Users\user1\.ssh\id_ed25519.pub | Set-Clipboard

範例 3：透過 SSH 遠端工作階段將文字複製到本機主機的剪貼簿

AsOSC52 參數可讓您在透過 SSH 連線到遠端工作時，設定本機電腦的剪貼簿。

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

範例 4：設定 **AsOSC52** 參數的預設值

您可以藉由檢查 或 $env:SSH_TTY 環境變數的值$env:SSH_CLIENT，透過 SSH 連線到遠端工作階段。 如果已設定其中一個變數，您就會透過 SSH 連線到遠端工作階段。 您可以使用這項資訊來設定 AsOSC52 參數的預設值。 將下列其中一行新增至 PowerShell 配置文件腳本。

$PSDefaultParameterValues['Set-Clipboard:AsOSC52'] = $env:SSH_CLIENT
$PSDefaultParameterValues['Set-Clipboard:AsOSC52'] = $env:SSH_TTY

如需 的詳細資訊 $PSDefaultParameterValues，請參閱 about_Parameters_Default_Values。

參數

-Append

指出 Cmdlet 應該新增至剪貼簿，而不是取代它。 根據預設，Cmdlet 會清除剪貼簿中的目前內容，並將其設定為新的內容。 指定此參數時，Cmdlet 會將新內容附加至目前的內容之後。

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-AsOSC52

透過 SSH 連線到遠端會話時， Set-Clipboard 設定遠端電腦的剪貼簿，而不是本機主機。 當您使用此參數時， Set-Clipboard 請使用 OSC52 ANSI 逸出序列來設定本機電腦的剪貼簿。

若要讓此功能運作，終端機應用程式必須支援 OSC52 ANSI 逸出序列。 Windows 終端機 支援這項功能。

此參數已在PowerShell 7.4中新增。

類型:	SwitchParameter
別名:	ToLocalhost
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Confirm

執行 Cmdlet 之前先提示您確認。

類型:	SwitchParameter
別名:	cf
Position:	Named
預設值:	False
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-PassThru

傳回 物件，表示您正在使用的專案。 根據預設，此 Cmdlet 不會產生任何輸出。

類型:	SwitchParameter
Position:	Named
預設值:	False
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Value

要新增至剪貼簿的字串值。

類型:	String[]
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	True
接受萬用字元:	False

-WhatIf

顯示執行 Cmdlet 後會發生的情況。 Cmdlet 未執行。

類型:	SwitchParameter
別名:	wi
Position:	Named
預設值:	False
必要:	False
接受管線輸入:	False
接受萬用字元:	False

輸入

String

您可以使用管線將包含要設定為剪貼簿內容的字串傳送至此 Cmdlet。

輸出

None

此 Cmdlet 不會傳回任何輸出。

備註

PowerShell 包含下列的 Set-Clipboard別名：

• 所有平臺：
  • scb

macOS 上的此 Cmdlet 支援已在 PowerShell 7.0.0 版本中新增。

相關連結

• Get-Clipboard