Partager via

Set-Clipboard

  • Référence
Module:
Microsoft.PowerShell.Management

Définit l’entrée actuelle du Presse-papiers Windows.

Syntaxe

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

L’applet Set-Clipboard de commande définit l’entrée actuelle du Presse-papiers Windows.

Exemples

Exemple 1 : Copier du texte dans le Presse-papiers

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

Exemple 2 : Copier le contenu d’un répertoire dans le Presse-papiers

Cet exemple copie le contenu du dossier spécifié dans le Presse-papiers.

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

Exemple 3 : Copier le contenu d’un fichier dans le Presse-papiers

Cet exemple canalise le contenu d’un fichier, une clé ssh publique, dans le Presse-papiers. Ensuite, la clé peut être collée dans une autre application, comme GitHub.

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

Paramètres

-Append

Indique que l’applet de commande doit ajouter au Presse-papiers au lieu de la remplacer. Par défaut, l’applet de commande efface le contenu actuel du Presse-papiers et le définit sur le nouveau contenu. Lorsque ce paramètre est spécifié, l’applet de commande ajoute le nouveau contenu après une nouvelle ligne au contenu actuel.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-AsHtml

Indique que l’applet de commande restitue le contenu en tant que code HTML dans le Presse-papiers.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Confirm

Vous demande une confirmation avant d’exécuter la commande cmdlet.

Type:SwitchParameter
Alias:cf
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-LiteralPath

Spécifie le chemin d’accès à l’élément copié dans le Presse-papiers. Contrairement à Path, la valeur de LiteralPath est utilisée exactement comme il est écrit. Aucun caractère n’est interprété en tant que caractère générique. Si le chemin d’accès inclut des caractères d’échappement, mettez-le entre des guillemets simples. Les guillemets simples indiquent à Windows PowerShell qu’aucun caractère ne doit être interprété en tant que séquence d’échappement.

Type:String[]
Alias:PSPath
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-Path

Spécifie le chemin d’accès à l’élément copié dans le Presse-papiers. Les caractères génériques sont autorisés.

Type:String[]
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:True

-Value

Spécifie, en tant que tableau de chaînes, le contenu à copier dans le Presse-papiers.

Type:String[]
Position:0
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-WhatIf

Montre ce qui se passe en cas d’exécution de la commande cmdlet. La commande cmdlet n’est pas exécutée.

Type:SwitchParameter
Alias:wi
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Entrées

String

Vous pouvez diriger une chaîne contenant le contenu à définir dans le Presse-papiers sur cette applet de commande.

Sorties

None

Cette applet de commande ne retourne pas de sortie.

Notes

Windows PowerShell inclut les alias suivants pour Set-Clipboard:

  • scb

Dans de rares cas, lorsque vous utilisez Set-Clipboard plusieurs fois en succession rapide, comme dans une boucle, le Presse-papiers n’est pas mis à jour ou vous recevez une erreur ExternalException . Cela peut être dû au moment où vous essayez de définir le Presse-papiers et qu’il est toujours en cours d’utilisation. Cela peut essayer d’éviter ce problème en ajoutant Start-Sleep -Milliseconds 100 à la boucle.