Importiert eine Aliasliste aus einer Datei.
Syntax
Import-Alias [-Path] <string> [-Force] [-PassThru] [-Scope <string>] [-Bestätigung] [-WhatIf] [<CommonParameters>]
Beschreibung
Mit dem Cmdlet "Import-Alias" wird eine Aliasliste aus einer Datei importiert.
Parameter
-Force
Ermöglicht dem Cmdlet das Importieren eines Alias, der bereits definiert und schreibgeschützt ist. Mit dem folgenden Befehl können Sie Informationen über die gegenwärtig definierten Aliase abrufen:
get-alias | Select-Object name,Options
Die Options-Eigenschaft enthält den Wert "ReadOnly", wenn der entsprechende Alias schreibgeschützt ist.
|
Erforderlich? |
false |
|
Position? |
named |
|
Standardwert |
|
|
Pipelineeingaben akzeptieren? |
false |
|
Platzhalterzeichen akzeptieren? |
false |
-PassThru
Gibt ein Objekt zurück, das den Alias darstellt. Standardmäßig wird von diesem Cmdlet keine Ausgabe generiert.
|
Erforderlich? |
false |
|
Position? |
named |
|
Standardwert |
|
|
Pipelineeingaben akzeptieren? |
false |
|
Platzhalterzeichen akzeptieren? |
false |
-Path <string>
Gibt den Pfad einer Datei an, die exportierte Aliasinformationen enthält. Platzhalter sind zulässig, müssen jedoch in einen einzelnen Namen aufgelöst werden können.
|
Erforderlich? |
true |
|
Position? |
1 |
|
Standardwert |
|
|
Pipelineeingaben akzeptieren? |
true (ByValue, ByPropertyName) |
|
Platzhalterzeichen akzeptieren? |
false |
-Scope <string>
Gibt den Bereich an, in den die Aliase importiert werden. Gültige Werte sind "global", "local", "script", oder eine Zahl in Bezug auf den aktuellen Bereich (0 bis zur Anzahl der Bereiche, wobei 0 der aktuelle Bereich und 1 der übergeordnete Bereich ist). Der Standardwert ist "local". Weitere Informationen finden Sie unter "about_Scopes".
|
Erforderlich? |
false |
|
Position? |
named |
|
Standardwert |
|
|
Pipelineeingaben akzeptieren? |
false |
|
Platzhalterzeichen akzeptieren? |
false |
-Bestätigung
Fordert Sie vor der Ausführung des Befehls zur Bestätigung auf.
|
Erforderlich? |
false |
|
Position? |
named |
|
Standardwert |
|
|
Pipelineeingaben akzeptieren? |
false |
|
Platzhalterzeichen akzeptieren? |
false |
-WhatIf
Beschreibt die Auswirkungen einer Ausführung des Befehls, ohne den Befehl tatsächlich auszuführen.
|
Erforderlich? |
false |
|
Position? |
named |
|
Standardwert |
|
|
Pipelineeingaben akzeptieren? |
false |
|
Platzhalterzeichen akzeptieren? |
false |
<CommonParameters>
Dieses Cmdlet unterstützt die folgenden allgemeinen Parameter: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer und -OutVariable. Weitere Informationen finden Sie unter about_Commonparameters.
Eingaben und Ausgaben
Der Eingabetyp ist der Typ der Objekte, die über die Pipeline an das Cmdlet übergeben werden können. Der Rückgabetyp ist der Typ der Objekte, die das Cmdlet zurückgibt.
|
Eingaben |
System.String Sie können eine Zeichenfolge mit einem Pfad über die Pipeline an Import-Alias übergeben. |
|
Ausgaben |
Keiner oder System.Management.Automation.AliasInfo Wenn Sie den Passthru-Parameter verwenden, gibt Import-Alias ein System.Management.Automation.AliasInfo-Objekt zurück, das den Alias darstellt. Andernfalls wird von diesem Cmdlet keine Ausgabe generiert. |
Beispiel 1
C:\PS>import-alias test.txt Beschreibung ----------- Mit diesem Befehl werden Aliasinformationen aus der Datei "test.txt" importiert.
Siehe auch