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 PowerShell actuelle. Les alias créés à l’aide New-Alias
de ne sont pas enregistrés après avoir quitté la session ou fermé PowerShell.
Vous pouvez utiliser l’applet de Export-Alias
commande pour enregistrer vos informations d’alias dans un fichier. Vous pourrez utiliser Import-Alias
ultérieurement pour récupérer ces informations d’alias enregistrées.
Exemples
Exemple 1 : Create 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 : Create 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, 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 redirige vers Format-List pour afficher toutes les informations le concernant.
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 autorisées sont :
None
: l’alias n’a aucune contrainte (valeur par défaut)ReadOnly
: l’alias peut être supprimé, mais ne peut pas être modifié, sauf à l’aide 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 un indicateur. Vous pouvez combiner plusieurs valeurs pour définir plusieurs indicateurs à l’aide de ce paramètre. Les valeurs peuvent être passées au paramètre Option sous la forme d’un tableau de valeurs ou d’une chaîne séparée 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 par 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 (de 0 au nombre d’étendues, où
0
est l’étendue actuelle et1
est 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 d'entrée vers cette applet de commande.
Sorties
None or System.Management.Automation.AliasInfo
Lorsque vous utilisez le paramètre Passthru , New-Alias
génère un objet System.Management.Automation.AliasInfo représentant le nouvel alias. Sinon, cette applet de commande ne génère aucune sortie.
Notes
- Pour créer un alias, utilisez
Set-Alias
ouNew-Alias
. Pour modifier un alias, utilisezSet-Alias
. Pour supprimer un alias, utilisezRemove-Item
.