Import-Alias
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 de 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 (de 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
Vous pouvez diriger une chaîne qui contient un chemin vers 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.