New-Alias

New-Alias
    [-Name] <String>
    [-Value] <String>
    [-Description <String>]
    [-Option <ScopedItemOptions>]
    [-PassThru]
    [-Scope <String>]
    [-Force]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

L’applet de commande New-Alias crée un alias dans la session PowerShell actuelle. Les alias créés à l’aide de New-Alias ne sont pas enregistrés après avoir quitté la session ou fermé PowerShell. Vous pouvez utiliser l’applet de commande Export-Alias pour enregistrer vos informations d’alias dans un fichier. Vous pouvez utiliser ultérieurement Import-Alias pour récupérer ces informations d’alias enregistrées.

New-Alias -Name "List" Get-ChildItem

Cette commande crée un alias nommé List pour représenter l’applet de commande Get-ChildItem.

Cette commande crée un alias nommé C pour représenter l’applet de commande Get-ChildItem. Il crée une description de « Alias gci rapide » pour l’alias et le rend en lecture seule.

New-Alias -Name "C" -Value Get-ChildItem -Description "Quick gci alias" -Option ReadOnly
Get-Alias -Name "C" | Format-List *

HelpUri             : https://go.microsoft.com/fwlink/?LinkID=2096492
ResolvedCommandName : Get-ChildItem
DisplayName         : C -> Get-ChildItem
ReferencedCommand   : Get-ChildItem
ResolvedCommand     : Get-ChildItem
Definition          : Get-ChildItem
Options             : ReadOnly
Description         : Quick gci alias
OutputType          : {System.IO.FileInfo, System.IO.DirectoryInfo}
Name                : C
CommandType         : Alias
Source              :
Version             :
Visibility          : Public
ModuleName          :
Module              :
RemotingCapability  : PowerShell
Parameters          : {[Path, System.Management.Automation.ParameterMetadata], [LiteralPath,
                      System.Management.Automation.ParameterMetadata], [Filter,
                      System.Management.Automation.ParameterMetadata], [Include,
                      System.Management.Automation.ParameterMetadata]…}

La commande Get-Alias redirigée vers Format-List affiche toutes les informations sur le nouvel alias.

function Set-ParentDirectory {Set-Location -Path ..}
New-Alias -Name .. -Value Set-ParentDirectory

La première commande crée la fonction Set-ParentDirectory, qui utilise Set-Location pour définir l’emplacement de travail sur le répertoire parent. La deuxième commande utilise New-Alias pour créer un alias de .. pour appeler la fonction Set-ParentDirectory. Étant donné que le paramètre Value nécessite une applet de commande, une fonction ou une valeur exécutable, vous devez créer une fonction personnalisée pour créer un alias qui utilise des paramètres. L’exécution de l’alias .. remplace l’emplacement actuel par le répertoire parent.

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.

Vous ne pouvez pas diriger les objets vers cette applet de commande.

Par défaut, cette applet de commande ne retourne aucune sortie.

Lorsque vous utilisez le paramètre PassThru, cette applet de commande renvoie un objet AliasInfo représentant le nouvel alias.

PowerShell inclut les alias suivants pour New-Alias:

• Toutes les plateformes :

  • nal

• Pour créer un alias, utilisez Set-Alias ou New-Alias. Pour modifier un alias, utilisez Set-Alias. Pour supprimer un alias, utilisez Remove-Alias.