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.