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.

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.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

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

-Confirm

Richiede conferma prima di eseguire il cmdlet.

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

-PassThru

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

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

-Value

Valori stringa da aggiungere agli Appunti.

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

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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