Crée un alias.
Syntaxe
New-Alias [-Name] <string> [-Value] <string> [-Description <string>] [-Force] [-Option {<None> | <ReadOnly> | <Constant> | <Private> | <AllScope>}] [-PassThru] [-Scope <string>] [-Confirm] [-WhatIf] [<CommonParameters>]
Description
L'applet de commande New-Alias crée un alias dans la session Windows PowerShell active. Les alias créés à l'aide de New-Alias ne sont pas enregistrés une fois que vous avez quitté la session ou fermé Windows PowerShell. Vous pouvez utiliser l'applet de commande Export-Alias pour enregistrer vos informations d'alias dans un fichier. Vous pouvez utiliser Import-Alias ultérieurement pour récupérer les informations d'alias enregistrées.
Paramètres
-Description <string>
Spécifie une description de l'alias. Vous pouvez taper toute chaîne. Si la description inclut des espaces, placez-la entre guillemets.
|
Obligatoire ? |
false |
|
Position ? |
named |
|
Valeur par défaut |
|
|
Accepter l'entrée de pipeline ? |
false |
|
Accepter les caractères génériques ? |
false |
-Force
Si elle est définie, elle agit comme l'applet de commande Set-Alias si l'alias nommé existe déjà.
|
Obligatoire ? |
false |
|
Position ? |
named |
|
Valeur par défaut |
|
|
Accepter l'entrée de pipeline ? |
false |
|
Accepter les caractères génériques ? |
false |
-Name <string>
Spécifie le nouvel alias. Vous pouvez utiliser tous les caractères alphanumériques dans un alias, mais le premier caractère ne peut pas être un nombre.
|
Obligatoire ? |
true |
|
Position ? |
1 |
|
Valeur par défaut |
|
|
Accepter l'entrée de pipeline ? |
true (ByPropertyName) |
|
Accepter les caractères génériques ? |
false |
-Option <ScopedItemOptions>
Définit une ou plusieurs propriétés facultatives de l'alias. Les valeurs valides sont :
-- None : ne définit pas d'options. (par défaut)
-- ReadOnly : l'alias ne peut pas être modifié, à moins que vous n'utilisiez le paramètre Force.
-- Constant : l'alias ne peut pas être modifié, même en utilisant le paramètre Force.
-- Private : l'alias est disponible uniquement dans la portée spécifiée par le paramètre Scope. Il est invisible dans toutes les autres portées.
|
Obligatoire ? |
false |
|
Position ? |
named |
|
Valeur par défaut |
|
|
Accepter l'entrée de pipeline ? |
false |
|
Accepter les caractères génériques ? |
false |
-PassThru
Retourne un objet représentant le nouvel alias. Par défaut, cette applet de commande ne génère aucune sortie.
|
Obligatoire ? |
false |
|
Position ? |
named |
|
Valeur par défaut |
|
|
Accepter l'entrée de pipeline ? |
false |
|
Accepter les caractères génériques ? |
false |
-Scope <string>
Spécifie la portée du nouvel alias. Les valeurs valides sont « Global », « Local » ou « Script », ou un nombre relatif à la portée actuelle (0 jusqu'au nombre de portées, où 0 est la portée actuelle et 1 son parent). « Local » est la valeur par défaut. Pour plus d'informations, consultez about_Scopes.
|
Obligatoire ? |
false |
|
Position ? |
named |
|
Valeur par défaut |
|
|
Accepter l'entrée de pipeline ? |
false |
|
Accepter les caractères génériques ? |
false |
-Value <string>
Spécifie le nom de l'applet de commande ou de l'élément de commande doté d'un alias.
|
Obligatoire ? |
true |
|
Position ? |
2 |
|
Valeur par défaut |
|
|
Accepter l'entrée de pipeline ? |
true (ByPropertyName) |
|
Accepter les caractères génériques ? |
false |
-Confirm
Vous invite à confirmer l'exécution de la commande.
|
Obligatoire ? |
false |
|
Position ? |
named |
|
Valeur par défaut |
|
|
Accepter l'entrée de pipeline ? |
false |
|
Accepter les caractères génériques ? |
false |
-WhatIf
Décrit le résultat que vous obtiendriez en exécutant la commande, sans réellement l'exécuter.
|
Obligatoire ? |
false |
|
Position ? |
named |
|
Valeur par défaut |
|
|
Accepter l'entrée de pipeline ? |
false |
|
Accepter les caractères génériques ? |
false |
<CommonParameters>
Cette applet de commande prend en charge les paramètres courants : -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer et -OutVariable. Pour plus d'informations, consultez about_Commonparameters.
Entrées et sorties
Le type d'entrée est le type des objets que vous pouvez diriger vers l'applet de commande. Le type de retour est le type des objets que l'applet de commande retourne.
|
Entrées |
Aucun Vous ne pouvez pas diriger d'entrée vers cette applet de commande. |
|
Sorties |
Aucun ou System.Management.Automation.AliasInfo Lorsque vous utilisez le paramètre Passthru, New-Alias génère un objet System.Management.Automation.AliasInfo qui représente le nouvel alias. Sinon, cette applet de commande ne génère aucune sortie. |
Remarques
Pour créer un alias, utilisez Set-Alias ou New-Alias. Pour modifier un alias, utilisez Set-Alias. Pour supprimer un alias, utilisez Remove-Item.
Exemple 1
C:\PS>new-alias list get-childitem Description ----------- Cette commande crée un alias nommé « list » pour représenter l'applet de commande Get-ChildItem.
Exemple 2
C:\PS>new-alias -name w -value get-wmiobject -description "quick wmi alias" -option ReadOnly C:\PS> get-alias -name w | format-list * Description ----------- Cette commande crée un alias nommé « w » pour représenter l'applet de commande Get-WMIObject. Elle crée une description, « alias de wmi rapide », pour l'alias et lui affecte l'attribut en lecture seule. La dernière ligne de la commande utilise Get-Alias pour obtenir le nouvel alias et le dirige vers Format-List pour afficher toutes les informations le concernant.
Voir aussi