Condividi tramite

Set-Clipboard

  • Riferimento
Modulo:
Microsoft.PowerShell.Management

Imposta il contenuto degli Appunti.

Sintassi

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

Descrizione

Il Set-Clipboard cmdlet imposta il contenuto degli Appunti.

Nota

In Linux, questo cmdlet richiede che l'utilità xclip sia nel percorso. In macOS questo cmdlet usa l'utilità pbcopy .

Esempio

Esempio 1: Copiare testo negli Appunti

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

Esempio 2: Copiare il contenuto di un file negli Appunti

Questo esempio invia tramite pipe il contenuto di un file, una chiave SSH pubblica, agli Appunti. La chiave può quindi essere incollata in un'altra applicazione, ad esempio GitHub.

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

Esempio 3: Copiare testo negli Appunti dell'host locale tramite una sessione remota SSH

Il parametro AsOSC52 consente di impostare gli Appunti del computer locale quando si è connessi a una sessione remota tramite SSH.

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

Esempio 4: Impostare il valore predefinito del parametro **AsOSC52**

È possibile rilevare se si è connessi a una sessione remota tramite SSH controllando il valore delle variabili di $env:SSH_CLIENT ambiente o $env:SSH_TTY . Se una di queste variabili è impostata, si è connessi a una sessione remota tramite SSH. È possibile usare queste informazioni per impostare il valore predefinito del parametro AsOSC52 . Aggiungere una delle righe seguenti allo script del profilo di PowerShell.

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

Per altre informazioni su $PSDefaultParameterValues, vedere about_Parameters_Default_Values.

Parametri

-Append

Indica che il cmdlet deve essere aggiunto agli Appunti anziché sostituirlo. Per impostazione predefinita, il cmdlet cancella il contenuto corrente dagli Appunti e lo imposta sul nuovo contenuto. Quando si specifica questo parametro, il cmdlet aggiunge il nuovo contenuto dopo una nuova riga al contenuto corrente.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-AsOSC52

Quando si è connessi a una sessione remota tramite SSH, Set-Clipboard imposta gli Appunti del computer remoto, non l'host locale. Quando si usa questo parametro, Set-Clipboard usa la sequenza di escape OSC52 ANSI per impostare gli Appunti del computer locale.

Per il funzionamento di questa funzionalità, l'applicazione terminale deve supportare la sequenza di escape ANSI OSC52. Il Terminale Windows supporta questa funzionalità.

Questo parametro è stato aggiunto in PowerShell 7.4.

Tipo:SwitchParameter
Alias:ToLocalhost
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Confirm

Richiede conferma prima di eseguire il cmdlet.

Tipo:SwitchParameter
Alias:cf
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-PassThru

Restituisce un oggetto che rappresenta l'elemento con cui si sta lavorando. Per impostazione predefinita, il cmdlet non genera alcun output.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Value

Valori stringa da aggiungere agli Appunti.

Tipo:String[]
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-WhatIf

Mostra gli effetti dell'esecuzione del cmdlet. Il cmdlet non viene eseguito.

Tipo:SwitchParameter
Alias:wi
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

String

È possibile inviare tramite pipe una stringa contenente il contenuto da impostare negli Appunti a questo cmdlet.

Output

None

Questo cmdlet non restituisce output.

Note

PowerShell include gli alias seguenti per Set-Clipboard:

  • Tutte le piattaforme:
    • scb

Il supporto per questo cmdlet in macOS è stato aggiunto nella versione di PowerShell 7.0.0.