Partager via

Import-Alias

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

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

Syntaxe

Import-Alias
      [-Path] <String>
      [-Scope <String>]
      [-PassThru]
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
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.

Type:SwitchParameter
Alias:cf
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques: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.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques: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é comme des caractères génériques. Si le chemin inclut des caractères d’échappement, placez-le entre guillemets simples. Les guillemets simples indiquent à PowerShell de ne pas interpréter de caractères comme séquences d’échappement.

Type:String
Alias:PSPath
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques: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.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques: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.

Type:String
Position:0
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:True

-Scope

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

  • Global
  • Local
  • Script
  • Nombre relatif à l’étendue actuelle (0 au nombre 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.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-WhatIf

Affiche ce qui se passerait si l’applet de commande s’exécute. L’applet de commande n’est pas exécutée.

Type:SwitchParameter
Alias:wi
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Entrées

String

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

Sorties

None or System.Management.Automation.AliasInfo

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