Partager via

Import-Alias

Module:
Microsoft.PowerShell.Utility Module

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

Syntaxe

ByPath (Par défaut) 

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

ByLiteralPath 

Import-Alias
    -LiteralPath <String>
    [-Scope <String>]
    [-PassThru]
    [-Force]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

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

À compter de Windows PowerShell 3.0, en tant que fonctionnalité de sécurité, Import-Alias ne remplace pas les alias existants par défaut. Pour remplacer un alias existant, après avoir assuré que le contenu du fichier d’alias est sécurisé, utilisez le paramètre Forcer.

Exemples

Exemple 1 : Importer des alias à partir d’un fichier

Import-Alias test.txt

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

Paramètres

-Confirm

Vous invite à confirmer avant d’exécuter l’applet de commande.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:False
Prend en charge les caractères génériques:False
DontShow:False
Alias:cf

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Force

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

Get-Alias | Select-Object Name, Options

Si l’alias correspondant est en lecture seule, il s’affiche dans la valeur de la propriété Options.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-LiteralPath

Spécifie le chemin d’accès à un fichier qui inclut des informations d’alias exportées. Contrairement au paramètre Path , la valeur du paramètre LiteralPath est utilisée exactement comme il est typé. Aucun caractère n’est interprété en tant que caractère générique. Si le chemin d’accès inclut des caractères d’échappement, mettez-le entre des guillemets simples. Les guillemets simples indiquent à PowerShell de ne pas interpréter de caractères comme séquences d’échappement.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:PSPath, DP

Jeux de paramètres

ByLiteralPath
Position:Named
Obligatoire:True
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-PassThru

Retourne un objet représentant l’élément avec lequel vous travaillez. Par défaut, cette applet de commande ne génère aucune sortie.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Path

Spécifie le chemin d’accès à un fichier qui inclut des informations d’alias exportées. Les caractères génériques sont autorisés, mais ils doivent être résolus en un seul nom.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:True
DontShow:False

Jeux de paramètres

ByPath
Position:0
Obligatoire:True
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-Scope

Spécifie l’étendue dans laquelle les alias sont importés. Les valeurs acceptables pour ce paramètre sont les suivantes :

  • Mondial
  • Local
  • Scénario
  • Nombre relatif à l’étendue actuelle (de 0 jusqu'au nombre total d’étendues, où 0 est l’étendue actuelle et 1 est son parent)

La valeur par défaut est Local. Pour plus d’informations, consultez about_Scopes.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-WhatIf

Affiche ce qui se passerait si l’applet de commande s’exécute. L’applet de commande ne s’exécute pas.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:False
Prend en charge les caractères génériques:False
DontShow:False
Alias:Wi

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

CommonParameters

Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.

Entrées

String

Vous pouvez acheminer une chaîne contenant un chemin 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 renvoie un objet aliasInfo représentant l’alias.

Notes

PowerShell inclut les alias suivants pour Import-Alias:

  • Toutes les plateformes :
    • ipal