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. Aliase, die mithilfe der Verwendung New-Alias
erstellt wurden, 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 später verwenden Import-Alias
, um diese gespeicherten Aliasinformationen abzurufen.
Beispiele
Beispiel 1: Erstellen eines Aliass für ein Cmdlet
New-Alias -Name "List" Get-ChildItem
Dieser Befehl erstellt einen Alias namens List, um das Cmdlet Get-ChildItem darzustellen.
Beispiel 2: Erstellen eines schreibgeschützten Alias für ein Cmdlet
New-Alias -Name "C" -Value Get-ChildItem -Description "quick gci alias" -Option ReadOnly
Get-Alias -Name "C" | Format-List *
Dieser Befehl erstellt einen Alias, der zum Darstellen des Get-ChildItem
Cmdlets benannt C
ist. Es erstellt eine Beschreibung, einen schnellen wmi-Alias für den Alias und macht es schreibgeschützt. Die letzte Zeile des Befehls verwendet Get-Alias
, um den neuen Alias abzurufen und sie an Format-List zu führen, um alle Informationen darüber anzuzeigen.
Parameter
-Confirm
Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Force
Gibt an, dass das Cmdlet wie Set-Alias
folgt funktioniert, wenn der Alias mit dem Namen bereits vorhanden ist.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | String |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Option
Gibt den Wert der Options-Eigenschaft des Alias an. Gültige Werte sind:
None
: Der Alias verfügt über keine Einschränkungen (Standardwert)ReadOnly
: Der Alias kann gelöscht werden, kann jedoch nicht geändert werden, außer mit dem Force-ParameterConstant
: 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 wird 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 kommatrennte Zeichenfolge dieser Werte an den Option-Parameter übergeben werden. Das Cmdlet kombiniert die Werte mithilfe eines binär-OR-Vorgangs. Das Übergeben von Werten als Array ist die einfachste Option und ermöglicht ihnen auch die Verwendung von Tabstopps für die Werte.
Geben Sie den Typ Get-Alias | Format-Table -Property Name, Options -AutoSize
"Options" ein, um die Eigenschaft "Options" aller Aliase in der Sitzung anzuzeigen.
Type: | ScopedItemOptions |
Accepted values: | None, ReadOnly, Constant, Private, AllScope, Unspecified |
Position: | Named |
Default value: | [System.Management.Automation.ScopedItemOptions]::None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PassThru
Gibt ein Objekt zurück, das das Element darstellt, mit dem Sie arbeiten. Standardmäßig wird von diesem Cmdlet keine Ausgabe generiert.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 durch die Anzahl der Bereiche, wobei
0
der aktuelle Bereich ist und1
dessen übergeordneter Bereich ist).
Local
ist die Standardoption. Weitere Informationen finden Sie unter about_Scopes.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Value
Gibt den Namen des Cmdlet- oder des Befehlselements an, dem ein Alias zugeordnet wird.
Type: | String |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-WhatIf
Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Eingaben
None
Eingaben können nicht an dieses Cmdlet weitergereicht werden.
Ausgaben
None or System.Management.Automation.AliasInfo
Wenn Sie den Passthru-Parameter verwenden, wird ein System.Management.Automation.AliasInfo-Objekt generiert, New-Alias
das den neuen Alias darstellt. Andernfalls wird von diesem Cmdlet keine Ausgabe generiert.
Hinweise
- Um einen neuen Alias zu erstellen, verwenden
Set-Alias
oderNew-Alias
. Um einen Alias zu ändern, verwenden SieSet-Alias
. Um einen Alias zu löschen, verwenden SieRemove-Item
.