Set-Clipboard
Définit le contenu du Presse-papiers.
Syntaxe
Default (Par défaut)
Set-Clipboard
[-Value] <string[]>
[-Append]
[-PassThru]
[-AsOSC52]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
L’applet de commande Set-Clipboard définit le contenu du Presse-papiers.
Remarque
Sur Linux, cette applet de commande nécessite que l’utilitaire de xclip soit dans le chemin d’accès. Sur macOS, cette applet de commande utilise l’utilitaire pbcopy.
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 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
Exemple 3 : Copier du texte dans le Presse-papiers de l’hôte local via une session distante SSH
Le paramètre AsOSC52 vous permet de définir le Presse-papiers de l’ordinateur local lorsqu’il est connecté à une session distante via SSH.
Set-Clipboard -Value "This is a test string" -AsOSC52
Exemple 4 : Définir la valeur par défaut du paramètre **AsOSC52**
Vous pouvez détecter si vous êtes connecté à une session distante via SSH en vérifiant la valeur des variables d’environnement $Env:SSH_CLIENT ou $Env:SSH_TTY. Si l’une de ces variables est définie, vous êtes connecté à une session distante via SSH. Vous pouvez utiliser ces informations pour définir la valeur par défaut du paramètre AsOSC52. Ajoutez l’une des lignes suivantes à votre script de profil PowerShell.
$PSDefaultParameterValues['Set-Clipboard:AsOSC52'] = $Env:SSH_CLIENT
$PSDefaultParameterValues['Set-Clipboard:AsOSC52'] = $Env:SSH_TTY
Pour plus d’informations sur $PSDefaultParameterValues, consultez about_Parameters_Default_Values.
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.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-AsOSC52
Quand vous êtes connecté à une session distante via SSH, Set-Clipboard définit le Presse-papiers de l’ordinateur distant, et non l’hôte local. Lorsque vous utilisez ce paramètre, Set-Clipboard utilise la séquence d’échappement ANSI OSC52 pour définir le Presse-papiers de l’ordinateur local.
Pour que cette fonctionnalité fonctionne, votre application terminale doit prendre en charge la séquence d’échappement ANSI OSC52. Le terminal Windows prend en charge cette fonctionnalité.
Ce paramètre a été ajouté dans PowerShell 7.4.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
| Alias: | ToLocalhost |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Confirm
Vous invite à confirmer avant d’exécuter l’applet de commande.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | False |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
| Alias: | cf |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-PassThru
Retourne un objet représentant l’élément avec lequel vous travaillez. Par défaut, cette applet de commande ne génère aucune sortie.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | False |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Value
Valeurs de chaîne à ajouter au Presse-papiers.
Propriétés du paramètre
| Type: | String[] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | True |
| Valeur du pipeline: | True |
| Valeur du pipeline par nom de propriété: | True |
| Valeur des arguments restants: | False |
-WhatIf
Affiche ce qui se passerait si l’applet de commande s’exécute. L’applet de commande n’est pas exécutée.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | False |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
| Alias: | Wi |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
CommonParameters
Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.
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 aucune sortie.
Notes
PowerShell inclut les alias suivants pour Set-Clipboard:
- Toutes les plateformes :
scb
La prise en charge de cette applet de commande sur macOS a été ajoutée dans la version powerShell 7.0.0.
