Import-Alias
Importiert eine Aliasliste aus einer Datei.
Syntax
Import-Alias
[-Path] <String>
[-Scope <String>]
[-PassThru]
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Import-Alias
-LiteralPath <String>
[-Scope <String>]
[-PassThru]
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Beschreibung
Das cmdlet Import-Alias
importiert eine Aliasliste aus einer Datei.
Ab Windows PowerShell 3.0 überschreibt Import-Alias
standardmäßig keine vorhandenen Aliase.
Um einen vorhandenen Alias zu überschreiben, verwenden Sie nach der Sicherstellung, dass der Inhalt der Aliasdatei sicher ist, den parameter Force.
Beispiele
Beispiel 1: Importieren von Aliasen aus einer Datei
Import-Alias test.txt
Mit diesem Befehl werden Aliasinformationen aus einer Datei namens test.txtimportiert.
Parameter
-Confirm
Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.
Typ: | SwitchParameter |
Aliase: | cf |
Position: | Named |
Standardwert: | False |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-Force
Ermöglicht dem Cmdlet das Importieren eines bereits definierten Alias oder schreibgeschützt. Mit dem folgenden Befehl können Sie Informationen zu den aktuell definierten Aliasen anzeigen:
Get-Alias | Select-Object Name, Options
Wenn der entsprechende Alias schreibgeschützt ist, wird er im Wert der Options-Eigenschaft angezeigt.
Typ: | SwitchParameter |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-LiteralPath
Gibt den Pfad zu einer Datei an, die exportierte Aliasinformationen enthält. Im Gegensatz zum Path-Parameter wird der Wert des LiteralPath--Parameters genau so verwendet, wie er eingegeben wird. Es werden keine Zeichen als Wildcards interpretiert. Wenn der Pfad Escapezeichen enthält, schließen Sie ihn in einfache Anführungszeichen ein. Einfache Anführungszeichen weisen PowerShell an, keine Zeichen als Escapesequenzen zu interpretieren.
Typ: | String |
Aliase: | PSPath, LP |
Position: | Named |
Standardwert: | None |
Erforderlich: | True |
Pipelineeingabe akzeptieren: | True |
Platzhalterzeichen akzeptieren: | False |
-PassThru
Gibt ein Objekt zurück, das das Element darstellt, mit dem Sie arbeiten. Standardmäßig generiert dieses Cmdlet keine Ausgabe.
Typ: | SwitchParameter |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-Path
Gibt den Pfad zu einer Datei an, die exportierte Aliasinformationen enthält. Wildcards sind zulässig, müssen jedoch in einen einzelnen Namen aufgelöst werden.
Typ: | String |
Position: | 0 |
Standardwert: | None |
Erforderlich: | True |
Pipelineeingabe akzeptieren: | True |
Platzhalterzeichen akzeptieren: | True |
-Scope
Gibt den Bereich an, in den die Aliase importiert werden. Die zulässigen Werte für diesen Parameter sind:
- Global
- 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)
Der Standardwert ist "Lokal". Weitere Informationen finden Sie unter about_Scopes.
Typ: | String |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-WhatIf
Zeigt, was passiert, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.
Typ: | SwitchParameter |
Aliase: | wi |
Position: | Named |
Standardwert: | False |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
Eingaben
Sie können eine Zeichenfolge senden, die einen Pfad zu Import-Alias
enthält.
Ausgaben
None or 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 generiert dieses Cmdlet keine Ausgabe.