Set-Clipboard

  • Riferimento
Modulo:
Microsoft.PowerShell.Management

Imposta la voce corrente degli Appunti di Windows.

Sintassi

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

Descrizione

Il Set-Clipboard cmdlet imposta la voce corrente degli Appunti di Windows.

Esempio

Esempio 1: Copiare testo negli Appunti

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

Esempio 2: Copiare il contenuto di una directory negli Appunti

In questo esempio il contenuto della cartella specificata viene copiato negli Appunti.

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

Esempio 3: 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

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

-AsHtml

Indica che il cmdlet esegue il rendering del contenuto come HTML negli Appunti.

Tipo:SwitchParameter
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

-LiteralPath

Specifica il percorso dell'elemento copiato negli Appunti. A differenza di Path, il valore di LiteralPath viene usato esattamente come viene scritto. Nessun carattere viene interpretato come carattere jolly. Se il percorso include caratteri di escape, racchiuderlo tra virgolette singole. Le virgolette singole indicano a Windows PowerShell di non interpretare i caratteri come sequenze di escape.

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

-Path

Specifica il percorso dell'elemento copiato negli Appunti. I caratteri jolly sono consentiti.

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

-Value

Specifica, come matrice di stringhe, il contenuto da copiare negli Appunti.

Tipo:String[]
Posizione:0
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

Windows PowerShell include gli alias seguenti per Set-Clipboard:

  • scb

In rari casi, quando si usano Set-Clipboard molte volte in successione rapida, ad esempio in un ciclo, gli Appunti non vengono aggiornati o si riceve un errore ExternalException . Questo può essere causato quando si tenta di impostare gli Appunti ed è ancora in uso. Questo può tentare di evitare questo problema aggiungendo Start-Sleep -Milliseconds 100 al ciclo .