Sdílet prostřednictvím

Import-Alias

  • Reference
Modul:
Microsoft.PowerShell.Utility

Importuje seznam aliasů ze souboru.

Syntaxe

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í.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky: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 .

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky: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.

Typ:String
Aliasy:PSPath, LP
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-PassThru

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

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky: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.

Typ:String
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky: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.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-WhatIf

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

Typ:SwitchParameter
Aliasy:wi
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky: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