Freigeben über

New-Alias

Modul:
Microsoft.PowerShell.Utility Module

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 einen neuen Alias in der aktuellen PowerShell-Sitzung. Aliase, die mithilfe von New-Alias erstellt wurden, werden nicht gespeichert, nachdem Sie die Sitzung beendet oder 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

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

Mit diesem Befehl wird ein Alias namens C erstellt, der das cmdlet Get-ChildItem 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 befehl Get-Alias, der an Format-List weitergeleitet wird, zeigt alle Informationen zum neuen Alias an.

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 Set-Location verwendet, um den Arbeitsspeicherort auf das übergeordnete Verzeichnis festzulegen. Der zweite Befehl verwendet New-Alias, um einen Alias von .. zum Aufrufen der Set-ParentDirectory-Funktion zu erstellen. 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. Das Ausführen des Alias .. ändert den aktuellen Speicherort in das übergeordnete Verzeichnis.

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:

  • None: 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
  • 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 auf Flaggen basierende 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 Option Parameter ü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 der Tab-Vervollständigung für die Werte.

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:

  • Global
  • Local
  • Script
  • Eine Zahl relativ zum aktuellen Bereich (0 bis zur Anzahl der Bereiche, wobei 0 der aktuelle Bereich ist und 1 das übergeordnete Element ist).

Local 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

Sie können keine Objekte an dieses Cmdlet weiterleiten.

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

Windows PowerShell enthält die folgenden Aliase für New-Alias:

  • nal

  • Verwenden Sie zum Erstellen eines neuen Alias Set-Alias oder New-Alias. Verwenden Sie Set-Alias, um einen Alias zu ändern. Verwenden Sie Remove-Item, um einen Alias zu löschen.