Freigeben über


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

String

Sie können eine Zeichenfolge senden, die einen Pfad zu Import-Aliasenthä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.