Share via

Import-Alias

  • Referenz
Modul:
Microsoft.PowerShell.Utility

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 Import-Alias Cmdlet importiert eine Aliasliste aus einer Datei.

Ab Windows PowerShell 3.0 werden vorhandene Aliase als Sicherheitsfeature Import-Alias standardmäßig nicht überschrieben. Zum Überschreiben eines vorhandenen Alias vergewissern Sie sich zunächst, dass der Inhalt der Aliasdatei sicher ist, und verwenden Sie dann den Force-Parameter.

Beispiele

Beispiel 1: Importieren von Aliasen aus einer Datei

Import-Alias test.txt

Dieser Befehl importiert die Aliasinformationen aus der Datei „test.txt“.

Parameter

-Confirm

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

Ermöglicht dem Cmdlet das Importieren eines Alias, der bereits definiert oder schreibgeschützt ist. Verwenden Sie folgenden Befehl, um Informationen über die aktuell definierten Aliase anzuzeigen:

Get-Alias | Select-Object Name, Options

Wenn der entsprechende Alias schreibgeschützt ist, wird dies im Wert der Options-Eigenschaft angezeigt.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 wurde. Es werden keine Zeichen als Platzhalter interpretiert. Wenn der Pfad Escapezeichen enthält, müssen Sie ihn in einfache Anführungszeichen einschließen. Einzelne Anführungszeichen weisen PowerShell an, keine Zeichen als Escapesequenzen zu interpretieren.

Type:String
Aliases:PSPath, LP
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-PassThru

Gibt ein Objekt zurück, das das Element darstellt, mit dem Sie arbeiten. Standardmäßig wird von diesem Cmdlet keine Ausgabe generiert.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Path

Gibt den Pfad zu einer Datei an, die exportierte Aliasinformationen enthält. Platzhalter sind zulässig, aber sie müssen in einem einzigen Namen aufgelöst werden.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:True

-Scope

Gibt den Bereich an, in den die Aliase importiert werden. Zulässige Werte für diesen Parameter:

  • Global
  • Lokal
  • Skript
  • Eine Zahl relativ zum aktuellen Bereich (0 durch die Anzahl der Bereiche, wobei 0 der aktuelle Bereich und 1 sein übergeordneter Bereich ist)

Der Standardwert ist Local. Weitere Informationen finden Sie unter about_Scopes.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Eingaben

String

Sie können eine Zeichenfolge, die einen Pfad enthält, an dieses Cmdlet übergeben.

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 Alias darstellt.

Hinweise

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

  • Alle Plattformen:
    • ipal