New-Alias
Erstellt einen neuen Alias.
Syntax
New-Alias
[-Name] <String>
[-Value] <String>
[-Description <String>]
[-Option <ScopedItemOptions>]
[-PassThru]
[-Scope <String>]
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Beschreibung
Das New-Alias
Cmdlet erstellt einen neuen Alias in der aktuellen PowerShell-Sitzung. Von der Verwendung New-Alias
erstellte Aliase werden nach dem Beenden der Sitzung nicht gespeichert oder PowerShell geschlossen.
Sie können das Export-Alias
Cmdlet verwenden, um Ihre Aliasinformationen in einer Datei zu speichern. Sie können diese gespeicherten Aliasinformationen später Import-Alias
abrufen.
Beispiele
Beispiel 1: Erstellen eines Alias für ein Cmdlet
New-Alias -Name "List" Get-ChildItem
Mit diesem Befehl wird ein Alias namens "List" erstellt, der das Cmdlet "Get-ChildItem" darstellt.
Beispiel 2: Erstellen eines schreibgeschützten Alias für ein Cmdlet
Mit diesem Befehl wird ein Alias erstellt C
, der Get-ChildItem
das Cmdlet darstellt. Es erstellt eine Beschreibung von "quick gci alias" für den Alias und macht ihn schreibgeschützt.
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]…}
Der Get-Alias
Befehl, der weitergeleitet wird, um Format-List
alle Informationen zum neuen Alias anzuzeigen.
Beispiel 3: Erstellen eines Alias für einen Befehl mit Parametern
function Set-ParentDirectory {Set-Location -Path ..}
New-Alias -Name .. -Value Set-ParentDirectory
Der erste Befehl erstellt die Funktion Set-ParentDirectory
, die zum Festlegen des Arbeitsspeicherorts auf das übergeordnete Verzeichnis verwendet Set-Location
wird. Mit dem zweiten Befehl wird New-Alias
ein Alias ..
zum Aufrufen der Set-ParentDirectory
Funktion erstellt. Da für den Parameter Value ein Cmdlet, eine Funktion oder ein ausführbarer Wert erforderlich ist, müssen Sie eine benutzerdefinierte Funktion erstellen, um einen Alias zu erstellen, der Parameter verwendet. Durch Ausführen des Alias ..
wird der aktuelle Speicherort in das übergeordnete Verzeichnis geändert.
Parameter
-Confirm
Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.
Typ: | SwitchParameter |
Aliase: | cf |
Position: | Named |
Standardwert: | False |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-Description
Gibt eine Beschreibung des Alias an. Sie können eine beliebige Zeichenfolge eingeben. Wenn die Beschreibung Leerzeichen enthält, müssen Sie sie in Anführungszeichen einschließen.
Typ: | String |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-Force
Gibt an, dass das Cmdlet wie Set-Alias
vorhanden wirkt, wenn der benannte Alias bereits vorhanden ist.
Typ: | SwitchParameter |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-Name
Gibt den neuen Alias an. Sie können alle alphanumerischen Zeichen in einem Alias verwenden, aber das erste Zeichen darf keine Zahl sein.
Typ: | String |
Position: | 0 |
Standardwert: | None |
Erforderlich: | True |
Pipelineeingabe akzeptieren: | True |
Platzhalterzeichen akzeptieren: | False |
-Option
Gibt den Wert der Options-Eigenschaft des Alias an. Gültige Werte sind:
None
: Der Alias hat keine Einschränkungen (Standardwert)ReadOnly
: Der Alias kann gelöscht werden, kann aber nicht geändert werden, außer mit dem Parameter ForceConstant
: Der Alias kann nicht gelöscht oder geändert werden.Private
: Der Alias ist nur im aktuellen Bereich verfügbar.AllScope
: Der Alias wird in alle neuen Bereiche kopiert, die erstellt werden.Unspecified
: Die Option ist nicht angegeben.
Diese Werte werden als flagbasierte Enumeration definiert. Sie können mehrere Werte kombinieren, um mehrere Flags mithilfe dieses Parameters festzulegen. Die Werte können als Array von Werten oder als kommagetrennte Zeichenfolge dieser Werte an den Parameter Option übergeben werden. Das Cmdlet kombiniert die Werte mithilfe eines Binary-OR-Vorgangs. Das Übergeben von Werten als Array ist die einfachste Option und ermöglicht ihnen auch die Verwendung des Tabstopps für die Werte.
Um die Options-Eigenschaft aller Aliase in der Sitzung anzuzeigen, geben Sie folgendes ein Get-Alias | Format-Table -Property Name, Options -AutoSize
.
Typ: | ScopedItemOptions |
Zulässige Werte: | None, ReadOnly, Constant, Private, AllScope, Unspecified |
Position: | Named |
Standardwert: | [System.Management.Automation.ScopedItemOptions]::None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-PassThru
Gibt ein Objekt zurück, das das Element darstellt, mit dem Sie arbeiten. Standardmäßig wird von diesem Cmdlet keine Ausgabe generiert.
Typ: | SwitchParameter |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-Scope
Gibt den Bereich des neuen Alias an. Zulässige Werte für diesen Parameter:
Global
Local
Script
- Eine Zahl relativ zum aktuellen Bereich (0 bis zur Anzahl der Bereiche, wobei
0
es sich um den aktuellen Bereich handelt und1
sein übergeordnetes Element ist).
Local
ist die Standardoption. Weitere Informationen finden Sie unter about_Scopes.
Typ: | String |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-Value
Gibt den Namen des Cmdlet- oder des Befehlselements an, dem ein Alias zugeordnet wird.
Typ: | String |
Position: | 1 |
Standardwert: | None |
Erforderlich: | True |
Pipelineeingabe akzeptieren: | True |
Platzhalterzeichen akzeptieren: | False |
-WhatIf
Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.
Typ: | SwitchParameter |
Aliase: | wi |
Position: | Named |
Standardwert: | False |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
Eingaben
None
Sie können keine Objekte an dieses Cmdlet weiterleiten.
Ausgaben
None
Standardmäßig gibt dieses Cmdlet keine Ausgabe zurück.
Wenn Sie den PassThru-Parameter verwenden, gibt dieses Cmdlet ein AliasInfo-Objekt zurück, das den neuen Alias darstellt.
Hinweise
PowerShell enthält die folgenden Aliase für New-Alias
:
Alle Plattformen:
nal
Um einen neuen Alias zu erstellen, verwenden
Set-Alias
oderNew-Alias
. Um einen Alias zu ändern, verwenden SieSet-Alias
. Verwenden SieRemove-Alias
zum Löschen eines Alias .