New-Alias

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

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 par l’utilisation New-Alias ne sont pas enregistrés après avoir quitté la session ou fermé 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 Force
  • Constant: l’alias ne peut pas être supprimé ou modifié
  • Private: l’alias est disponible uniquement dans l’étendue actuelle
  • AllScope: l’alias est copié dans toutes les nouvelles étendues créées
  • Unspecified: 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 et 1 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.

AliasInfo

Lorsque vous utilisez le paramètre PassThru , cette applet de commande retourne un objet AliasInfo représentant le nouvel alias.

Notes

PowerShell inclut les alias suivants pour New-Alias:

  • Toutes les plateformes :

    • nal

  • Pour créer un alias, utilisez Set-Alias ou New-Alias. Pour modifier un alias, utilisez Set-Alias. Pour supprimer un alias, utilisez Remove-Alias.