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 Import-Alias de commande 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 Force .

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 demande une confirmation 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 qui est 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 sur les alias exportés. 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.

Type:String
Alias:PSPath, LP
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 que vous utilisez. Par défaut, cette applet de commande ne génère aucun résultat.

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 sur les alias exportés. Les caractères génériques sont autorisés, mais ils doivent correspondre à un nom unique.

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

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
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 à 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 l’alias.

Notes

PowerShell inclut les alias suivants pour Import-Alias:

  • Toutes les plateformes :
    • ipal