Freigeben über

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 Cmdlet New-Alias erstellt einen neuen Alias in der aktuellen PowerShell-Sitzung. Mit New-Alias erstellte Aliase werden nicht gespeichert, nachdem Sie die Sitzung beendet oder PowerShell geschlossen haben. Sie können das Export-Alias-Cmdlet verwenden, um die Aliasinformationen in einer Datei zu speichern. Sie können später Import-Alias verwenden, um diese gespeicherten Aliasinformationen abzurufen.

Beispiele

Beispiel 1: Create eines Alias für ein Cmdlet

PS C:\> New-Alias -Name "List" Get-ChildItem

Mit diesem Befehl wird ein Alias namens List erstellt, der das Cmdlet Get-ChildItem darstellt.

Beispiel 2: Create eines schreibgeschützten Alias für ein Cmdlet

PS C:\> New-Alias -Name "W" -Value Get-WmiObject -Description "quick wmi alias" -Option ReadOnly
PS C:\> Get-Alias -Name "W" | Format-List *

Mit diesem Befehl wird ein Alias namens W erstellt, der das Cmdlet Get-WmiObject darstellt. Es erstellt eine Beschreibung ( schnelle wmi-Alias) für den Alias und macht ihn schreibgeschützt. Die letzte Zeile des Befehls verwendet Get-Alias, um den neuen Alias abzurufen, und übergibt ihn an Format-List, um alle zugehörigen Informationen 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 verhält, 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:

  • Keine: Der Alias weist keine Einschränkungen auf (Standardwert)
  • ReadOnly: Der Alias kann gelöscht, aber nicht geändert werden, außer mit dem Force-Parameter .
  • Konstant: Der Alias kann nicht gelöscht oder geändert werden.
  • Privat: Der Alias ist nur im aktuellen Bereich verfügbar.
  • AllScope: Der Alias wird in alle neuen Bereiche kopiert, die erstellt werden.
  • Nicht angegeben: Die Option ist nicht angegeben.

Um die Options-Eigenschaft aller Aliase in der Sitzung anzuzeigen, geben Sie ein Get-Alias | Format-Table -Property Name, Options -AutoSize.

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
  • Lokal
  • Skript
  • Eine Zahl relativ zum aktuellen Bereich (0 bis zur Anzahl der Bereiche, wobei 0 der aktuelle Bereich und 1 sein übergeordnetes Element ist).

Lokal ist die Standardeinstellung. 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, generiert New-Alias ein System.Management.Automation.AliasInfo-Objekt , das den neuen Alias darstellt. Andernfalls wird von diesem Cmdlet keine Ausgabe generiert.

Hinweise

  • 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-Item.