Číst v angličtině

Sdílet prostřednictvím

Export-Alias

  • Reference
Modul:
Microsoft.PowerShell.Utility

Exportuje informace o aktuálně definovaných aliasech do souboru.

Syntaxe

PowerShell 
Export-Alias
      [-Path] <String>
      [[-Name] <String[]>]
      [-PassThru]
      [-As <ExportAliasFormat>]
      [-Append]
      [-Force]
      [-NoClobber]
      [-Description <String>]
      [-Scope <String>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
PowerShell 
Export-Alias
      -LiteralPath <String>
      [[-Name] <String[]>]
      [-PassThru]
      [-As <ExportAliasFormat>]
      [-Append]
      [-Force]
      [-NoClobber]
      [-Description <String>]
      [-Scope <String>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

Rutina Export-Alias exportuje aliasy v aktuální relaci do souboru. Pokud výstupní soubor neexistuje, rutina ho vytvoří.

Export-Alias může exportovat aliasy v určitém oboru nebo všech oborech, může vygenerovat data ve formátu CSV nebo jako řadu příkazů Set-Alias, které můžete přidat do relace nebo do profilu PowerShellu.

Příklady

Příklad 1: Export aliasu

PowerShell 
Export-Alias -Path "Alias.csv"

Tento příkaz exportuje informace o aktuálním aliasu do souboru s názvem Alias.csv v aktuálním adresáři.

Příklad 2: Export aliasu, pokud soubor exportu již neexistuje

PowerShell 
Export-Alias -Path "Alias.csv" -NoClobber

Tento příkaz exportuje aliasy v aktuální relaci do souboru Alias.csv.

Protože je zadaný parametr NoClobber, příkaz selže, pokud Alias.csv soubor již v aktuálním adresáři existuje.

Příklad 3: Připojení aliasů k souboru

PowerShell 
Export-Alias -Path "Alias.csv" -Append -Description "Appended Aliases" -Force

Tento příkaz připojí aliasy v aktuální relaci k souboru Alias.csv.

Příkaz používá parametr Description k přidání popisu do komentářů v horní části souboru.

Příkaz také používá parametr Force k přepsání všech existujících Alias.csv souborů, i když mají atribut jen pro čtení.

Příklad 4: Export aliasů jako skriptu

PowerShell 
Export-Alias -Path "alias.ps1" -As Script
Add-Content -Path $Profile -Value (Get-Content alias.ps1)
$S = New-PSSession -ComputerName Server01
Invoke-Command -Session $S -FilePath .\alias.ps1

Tento příklad ukazuje, jak použít formát souboru skriptu, který Export-Alias vygeneruje.

První příkaz exportuje aliasy v relaci do souboru Alias.ps1. Používá parametr As s hodnotou Script k vygenerování souboru, který obsahuje Set-Alias příkaz pro každý alias.

Druhý příkaz přidá aliasy v souboru Alias.ps1 do profilu CurrentUser-CurrentHost. Cesta k profilu se uloží do proměnné $Profile. Příkaz pomocí rutiny Get-Content získá aliasy ze souboru Alias.ps1 a rutiny Add-Content k jejich přidání do profilu. Další informace najdete v tématu about_Profiles.

Třetí a čtvrtý příkaz přidá aliasy v souboru Alias.ps1 do vzdálené relace na počítači Server01. Třetí příkaz k vytvoření relace používá rutinu New-PSSession. Čtvrtý příkaz používá parametr FilePath rutiny Invoke-Command ke spuštění souboru Alias.ps1 v nové relaci.

Parametry

-Append

Označuje, že tato rutina připojí výstup k zadanému souboru místo přepsání existujícího obsahu tohoto souboru.

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

-As

Určuje výstupní formát. Sdílený svazek clusteru je výchozí. Přijatelné hodnoty pro tento parametr jsou:

  • CSV. Formát hodnot oddělených čárkami (CSV).
  • Skript. Vytvoří Set-Alias příkaz pro každý exportovaný alias. Pokud pojmenujete výstupní soubor s příponou názvu souboru .ps1, můžete ho spustit jako skript pro přidání aliasů do jakékoli relace.
Typ:ExportAliasFormat
Přípustné hodnoty:Csv, Script
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-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

-Description

Určuje popis exportovaného souboru. Popis se zobrazí jako komentář v horní části souboru za informacemi záhlaví.

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

-Force

Vynutí spuštění příkazu bez výzvy k potvrzení uživatele.

Přepíše výstupní soubor, i když je u souboru nastavený atribut jen pro čtení.

Ve výchozím nastavení Export-Alias přepsat soubory bez upozornění, pokud není nastaven atribut jen pro čtení nebo skrytý atribut nebo NoClobber parametr se použije v příkazu. Parametr NoClobber má přednost před parametrem Force při použití obou příkazů.

Parametr Force nemůže vynutit, aby Export-Alias přepsal soubory skrytým atributem.

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 výstupnímu souboru. Na rozdíl od Pathse 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, LP
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-Name

Určuje názvy jako pole aliasů, které se mají exportovat. Jsou povoleny zástupné cardy.

Ve výchozím nastavení Export-Alias exportují všechny aliasy v relaci nebo oboru.

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

-NoClobber

Označuje, že tato rutina zabraňuje Export-Alias přepsání všech souborů, i když se v příkazu použije parametr Force.

Pokud parametr NoClobber vynecháte, Export-Alias přepíše existující soubor bez upozornění, pokud v souboru není nastavený atribut jen pro čtení. NoClobber má přednost před parametrem Force, který umožňuje Export-Alias přepsat soubor atributem jen pro čtení.

NoClobber nezabrání přidání obsahu do existujícího souboru parametru Append.

Typ:SwitchParameter
Aliasy:NoOverwrite
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
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 výstupnímu souboru. Jsou povoleny zástupné cardy, ale výsledná hodnota cesty se musí přeložit na jeden název souboru.

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

-Scope

Určuje obor, ze kterého mají být aliasy exportovány. Přijatelné hodnoty pro tento parametr jsou:

  • Global
  • Local
  • Script
  • Čí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 Local. 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

None

Do této rutiny nemůžete roušit objekty.

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 Export-Alias:

  • Všechny platformy:
    • epal
  • Do souboru můžete Export-Aliases.