Import-Alias

Référence

Module:: Microsoft.PowerShell.Utility

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

Syntax

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 garanti la sécurité du contenu du fichier alias, 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
Aliases:	cf
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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'affichera dans la valeur de la propriété Options.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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 telle qu'elle est tapée. 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 les caractères comme des séquences d’échappement.

Type:	String
Aliases:	PSPath, LP
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	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
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	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
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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
Aliases:	wi
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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 , 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.