New-Alias
Erstellt einen neuen Alias.
Syntax
Default (Standard)
New-Alias
[-Name] <String>
[-Value] <String>
[-Description <String>]
[-Option <ScopedItemOptions>]
[-PassThru]
[-Scope <String>]
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Beschreibung
Das cmdlet New-Alias erstellt in der aktuellen Windows PowerShell-Sitzung einen neuen Alias. Aliase, die mit New-Alias- erstellt wurden, werden nicht gespeichert, nachdem Sie die Sitzung beendet oder Windows PowerShell geschlossen haben. Sie können das Cmdlet Export-Alias verwenden, um Ihre Aliasinformationen in einer Datei zu speichern. Sie können später Import-Alias- verwenden, um diese gespeicherten Aliasinformationen abzurufen.
Beispiele
Beispiel 1: Erstellen eines Alias für ein Cmdlet
PS C:\> New-Alias -Name "List" Get-ChildItem
Mit diesem Befehl wird ein Alias namens "Liste" erstellt, der das cmdlet Get-ChildItem darstellt.
Beispiel 2: Erstellen 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. Er erstellt eine Beschreibung, einen schnellen 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 es an Format-List zu führen, um alle Informationen darüber anzuzeigen.
Parameter
-Confirm
Fordert Sie zur Bestätigung auf, bevor Sie das Cmdlet ausführen.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | False |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
| Aliase: | vgl |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Description
Gibt eine Beschreibung des Alias an. Sie können eine beliebige Zeichenfolge eingeben. Wenn die Beschreibung Leerzeichen enthält, schließen Sie sie in Anführungszeichen ein.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Force
Gibt an, dass das Cmdlet wie Set-Alias fungiert, wenn der benannte Alias bereits vorhanden ist.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Name
Gibt den neuen Alias an. Sie können beliebige alphanumerische Zeichen in einem Alias verwenden, aber das erste Zeichen darf keine Zahl sein.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | 0 |
| Obligatorisch: | True |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
-Option
Gibt den Wert der Options -Eigenschaft des Alias an. Gültige Werte sind:
- Keine: Der Alias hat keine Einschränkungen (Standardwert)
- ReadOnly: Der Alias kann gelöscht werden, kann jedoch nicht geändert werden, außer mithilfe des Parameters Force
- Konstante: 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.
Geben Sie ein, um die eigenschaft Get-Alias | Format-Table -Property Name, Options -AutoSize aller Aliase in der Sitzung anzuzeigen.
Parametereigenschaften
| Typ: | ScopedItemOptions |
| Standardwert: | [System.Management.Automation.ScopedItemOptions]::None |
| Zulässige Werte: | None, ReadOnly, Constant, Private, AllScope, Unspecified |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-PassThru
Gibt ein Objekt zurück, das das Element darstellt, mit dem Sie arbeiten. Standardmäßig generiert dieses Cmdlet keine Ausgabe.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Scope
Gibt den Bereich des neuen Alias an. Die zulässigen Werte für diesen Parameter sind:
- Weltweit
- Lokal
- Skript
- Eine Zahl relativ zum aktuellen Bereich (0 bis zur Anzahl der Bereiche, wobei 0 der aktuelle Bereich ist und 1 das übergeordnete Element ist).
Lokal ist die Standardeinstellung. Weitere Informationen finden Sie unter about_Scopes.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Value
Gibt den Namen des Cmdlets oder Befehlselements an, das aliast wird.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | 1 |
| Obligatorisch: | True |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
-WhatIf
Zeigt, was passiert, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | False |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
| Aliase: | Wi |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
CommonParameters
Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.
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 generiert dieses Cmdlet keine Ausgabe.
Hinweise
Verwenden Sie Set-Alias oder "New-Alias", um einen neuen Alias zu erstellen. Verwenden Sie Set-Alias-, um einen Alias zu ändern. Verwenden Sie "Remove-Item", um einen Alias zu löschen.