Share via

New-Alias

  • Referenz
Modul:
Microsoft.PowerShell.Utility

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 mit erstellt New-Alias wurden, werden nicht gespeichert, nachdem Sie die Sitzung beendet oder PowerShell schließen. 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: Create 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: Create einen 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 *

Mit diesem Befehl wird ein Alias mit dem Namen erstellt C , der das Get-ChildItem Cmdlet darstellt. Es erstellt eine Beschreibung ( quick gci alias) für den Alias und macht ihn schreibgeschützt. Die letzte Zeile des Befehls verwendet Get-Alias , um den neuen Alias abzurufen, und leitet ihn an Format-List, 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 so handelt, als Set-Alias ob 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 hat keine Einschränkungen (Standardwert)
  • ReadOnly: Der Alias kann gelöscht, aber nicht geändert werden, außer mit dem Force-Parameter
  • Constant: 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 miteinander kombinieren, um mehrere Flags mit diesem Parameter festzulegen. Die Werte können als Array von Werten oder als durch Trennzeichen getrennte Zeichenfolge dieser Werte an den Parameter Option ü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 es Ihnen auch, die Tabulatorvervollständigung für die Werte zu verwenden.

Geben Sie ein, um die Options-Eigenschaft aller Aliase in der Sitzung Get-Alias | Format-Table -Property Name, Options -AutoSizeanzuzeigen.

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 und 1 sein ü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

Sie können keine Objekte an dieses Cmdlet übergeben.

Ausgaben

None

Standardmäßig gibt dieses Cmdlet keine Ausgabe zurück.

AliasInfo

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

  • Verwenden Sie Set-Alias oder New-Alias, um einen neuen Alias zu erstellen. Um einen Alias zu ändern, verwenden Sie Set-Alias. Um einen Alias zu löschen, verwenden Sie Remove-Alias.