New-Alias
Crée un alias.
Syntax
New-Alias
[-Name] <String>
[-Value] <String>
[-Description <String>]
[-Option <ScopedItemOptions>]
[-PassThru]
[-Scope <String>]
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
L’applet New-Alias
de commande crée un alias dans la session Windows PowerShell actuelle. Les alias créés par l’utilisation New-Alias
ne sont pas enregistrés après avoir quitté la session ou fermé Windows PowerShell.
Vous pouvez utiliser l’applet Export-Alias
de commande pour enregistrer vos informations d’alias dans un fichier. Vous pouvez utiliser ultérieurement Import-Alias
pour récupérer ces informations d’alias enregistrées.
Exemples
Exemple 1 : Créer un alias pour une applet de commande
New-Alias -Name "List" Get-ChildItem
Cette commande crée un alias nommé List pour représenter l’applet de commande Get-ChildItem.
Exemple 2 : Créer un alias en lecture seule pour une applet de commande
New-Alias -Name "C" -Value Get-ChildItem -Description "quick gci alias" -Option ReadOnly
Get-Alias -Name "C" | Format-List *
Cette commande crée un alias nommé C
pour représenter l’applet de Get-ChildItem
commande. Il crée une description, un alias wmi rapide, pour l’alias et le rend en lecture seule. La dernière ligne de la commande utilise Get-Alias
pour obtenir le nouvel alias et le canaliser vers Format-List pour afficher toutes les informations à son sujet.
Paramètres
-Confirm
Vous demande une confirmation avant d’exécuter l’applet de commande.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Description
Spécifie une description de l'alias. Vous pouvez entrer n'importe quelle chaîne. Si la description inclut des espaces, mettez-la entre guillemets.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Force
Indique que l’applet de commande agit comme Set-Alias
si l’alias nommé existe déjà.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Name
Spécifie le nouvel alias. Vous pouvez utiliser des caractères alphanumériques dans un alias, mais le premier caractère ne peut pas être un nombre.
Type: | String |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Option
Spécifie la valeur de la propriété Options de l’alias. Les valeurs valides sont :
None
: l’alias n’a aucune contrainte (valeur par défaut)ReadOnly
: l’alias peut être supprimé, mais ne peut pas être modifié à l’exception du paramètre ForceConstant
: l’alias ne peut pas être supprimé ou modifiéPrivate
: l’alias est disponible uniquement dans l’étendue actuelleAllScope
: l’alias est copié dans toutes les nouvelles étendues crééesUnspecified
: l’option n’est pas spécifiée
Ces valeurs sont définies comme une énumération basée sur des indicateurs. Vous pouvez combiner plusieurs valeurs pour définir plusieurs indicateurs à l’aide de ce paramètre. Les valeurs peuvent être transmises au paramètre Option en tant que tableau de valeurs ou sous forme de chaîne séparées par des virgules de ces valeurs. L’applet de commande combine les valeurs à l’aide d’une opération binary-OR. La transmission de valeurs en tant que tableau est l’option la plus simple et vous permet également d’utiliser la saisie semi-automatique sous forme de tabulation sur les valeurs.
Pour afficher la propriété Options de tous les alias de la session, tapez Get-Alias | Format-Table -Property Name, Options -AutoSize
.
Type: | ScopedItemOptions |
Accepted values: | None, ReadOnly, Constant, Private, AllScope, Unspecified |
Position: | Named |
Default value: | [System.Management.Automation.ScopedItemOptions]::None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PassThru
Retourne un objet représentant l’élément que vous utilisez. Par défaut, cette applet de commande ne génère aucun résultat.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Scope
Spécifie l'étendue du nouvel alias. Les valeurs valides pour ce paramètre sont :
Global
Local
Script
- Nombre relatif à l’étendue actuelle (0 au nombre d’étendues, où
0
est l’étendue actuelle et1
son parent).
Local
est la valeur par défaut. Pour plus d’informations, consultez about_Scopes.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Value
Spécifie le nom de l'élément d'applet de commande ou de commande auquel est associé un alias.
Type: | String |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-WhatIf
Montre ce qui se passe en cas d’exécution de l’applet de commande. L’applet de commande n’est pas exécutée.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Entrées
None
Vous ne pouvez pas diriger les objets vers cette applet de commande.
Sorties
None
Par défaut, cette applet de commande ne retourne aucune sortie.
Lorsque vous utilisez le paramètre PassThru , cette applet de commande retourne un objet AliasInfo représentant le nouvel alias.
Notes
Windows PowerShell inclut les alias suivants pour New-Alias
:
nal
Pour créer un alias, utilisez
Set-Alias
ouNew-Alias
. Pour modifier un alias, utilisezSet-Alias
. Pour supprimer un alias, utilisezRemove-Item
.
Liens associés
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour