Import-Alias

  • Reference
Modul:
Microsoft.PowerShell.Utility

Importuje seznam aliasů ze souboru.

Syntax

Import-Alias
      [-Path] <String>
      [-Scope <String>]
      [-PassThru]
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Import-Alias
      -LiteralPath <String>
      [-Scope <String>]
      [-PassThru]
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

Rutina Import-Alias importuje seznam aliasů ze souboru.

Počínaje windows PowerShellem 3.0 se ve výchozím nastavení nepřepisují existující aliasy jako funkce Import-Alias zabezpečení. Pokud chcete přepsat existující alias, po zajištění bezpečnosti obsahu souboru aliasu použijte parametr Force .

Příklady

Příklad 1: Import aliasů ze souboru

Import-Alias test.txt

Tento příkaz importuje informace aliasu ze souboru s názvem test.txt.

Parametry

-Confirm

Před spuštěním rutiny zobrazí výzvu k potvrzení.

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

-Force

Umožňuje rutině importovat alias, který je již definovaný nebo je jen pro čtení. K zobrazení informací o aktuálně definovaných aliasech můžete použít následující příkaz:

Get-Alias | Select-Object Name, Options

Pokud je odpovídající alias jen pro čtení, zobrazí se v hodnotě vlastnosti Options .

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

-LiteralPath

Určuje cestu k souboru, který obsahuje informace o exportovaných aliasech. Na rozdíl od parametru Path se hodnota parametru LiteralPath používá přesně tak, jak je zadána. Žádné znaky nejsou interpretovány jako zástupné znaky. Pokud cesta obsahuje řídicí znaky, uzavřete ji do jednoduchých uvozovek. Jednoduché uvozovky říkají PowerShellu, aby nepřekládaly žádné znaky jako řídicí sekvence.

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

-PassThru

Vrátí objekt představující položku, se kterou pracujete. Ve výchozím nastavení tato rutina negeneruje žádný výstup.

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

-Path

Určuje cestu k souboru, který obsahuje informace o exportovaných aliasech. Zástupné cardy jsou povolené, ale musí se přeložit na jeden název.

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

-Scope

Určuje obor, do kterého se aliasy importují. Tento parametr přijímá tyto hodnoty:

  • Globální
  • Místní
  • Skript
  • Číslo relativní k aktuálnímu oboru (0 až počet oborů, kde 0 je aktuální obor a 1 je jeho nadřazený)

Výchozí hodnota je Místní. Další informace najdete v tématu about_Scopes.

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

-WhatIf

Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěna.

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

Vstupy

String

Řetězec, který obsahuje cestu k této rutině, můžete převést.

Výstupy

None

Ve výchozím nastavení tato rutina nevrací žádný výstup.

AliasInfo

Pokud použijete parametr PassThru , vrátí tato rutina objekt AliasInfo představující alias.

Poznámky

PowerShell obsahuje následující aliasy pro Import-Alias:

  • Všechny platformy:
    • ipal