Partager via


Import-Alias

Importe une liste d'alias à partir d'un fichier.

Syntaxe

Import-Alias [-Path] <string> [-Force] [-PassThru] [-Scope <string>] [-Confirm] [-WhatIf] [<CommonParameters>]

Description

L'applet de commande Import-Alias importe une liste d'alias à partir d'un fichier.

Paramètres

-Force

Permet à l'applet de commande d'importer un alias qui est déjà défini et en lecture seule. Vous pouvez utiliser la commande suivante pour afficher des informations sur les alias définis actuellement :

get-alias | Select-Object name,Options

La valeur de la propriété Options inclura « ReadOnly » si l'alias correspondant est en lecture seule.

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 l'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

-Path <string>

Spécifie le chemin d'accès au fichier qui inclut les informations d'alias exportées. Les caractères génériques sont autorisés, mais doivent être résolus en un nom unique.

Obligatoire ?

true

Position ?

1

Valeur par défaut

Accepter l'entrée de pipeline ?

true (ByValue, ByPropertyName)

Accepter les caractères génériques ?

false

-Scope <string>

Spécifie la portée dans laquelle les alias sont importés. 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

-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

System.String

Vous pouvez diriger une chaîne qui contient un chemin d'accès vers Import-Alias.

Sorties

Aucun ou System.Management.Automation.AliasInfo

Lorsque vous utilisez le paramètre Passthru, Import-Alias retourne un objet System.Management.Automation.AliasInfo qui représente l'alias. Sinon, cette applet de commande ne génère aucune sortie.

Exemple 1

C:\PS>import-alias test.txt

Description
-----------
Cette commande importe les informations d'alias à partir d'un fichier nommé test.txt.





Voir aussi

Concepts

Export-Alias
Get-Alias
New-Alias
Set-Alias