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 jako funkcí zabezpečení Import-Alias ve výchozím nastavení nepřepíše existující aliasy. 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 vás vyzve 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án. Žá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
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í. Přijatelné hodnoty pro tento parametr jsou:

  • 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

Ukazuje, co se stane, když se rutina spustí. Rutina se nespustí.

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 Import-Alias, můžete pipetovat .

Výstupy

None or System.Management.Automation.AliasInfo

Pokud použijete parametr Passthru, Import-Alias vrátí objekt System.Management.Automation.AliasInfo, který představuje alias. Jinak tato rutina negeneruje žádný výstup.