Sdílet prostřednictvím

Export-Console

  • Reference
Modul:
Microsoft.PowerShell.Core

Exportuje názvy modulů snap-in v aktuální relaci do souboru konzoly.

Syntaxe

Export-Console
      [[-Path] <String>]
      [-Force]
      [-NoClobber]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

Rutina Export-Console exportuje názvy modulů snap-in windows PowerShellu v aktuální relaci do souboru konzoly Windows PowerShellu (.psc1). Pomocí této rutiny můžete uložit moduly snap-in pro použití v budoucích relacích.

Pokud chcete do relace přidat moduly snap-in v souboru konzoly .psc1, spusťte windows PowerShell (PowerShell.exe) na příkazovém řádku pomocí Cmd.exe nebo jiné relace Prostředí Windows PowerShell a potom pomocí parametru PSConsoleFile PowerShell.exe zadejte soubor konzoly.

Další informace o modulech snap-in prostředí Windows PowerShell najdete v tématu about_PSSnapins.

Příklady

Příklad 1: Export názvů modulů snap-in v aktuální relaci

PS C:\> Export-Console -Path $pshome\Consoles\ConsoleS1.psc1

Tento příkaz exportuje názvy modulů snap-in prostředí Windows PowerShell v aktuální relaci do souboru ConsoleS1.psc1 ve složce Konzoly instalační složky prostředí Windows PowerShell $pshome.

Příklad 2: Export názvů modulů snap-in do nejnovějšího souboru konzoly

Export-Console

Tento příkaz exportuje názvy modulů snap-in prostředí Windows PowerShell z aktuální relace do souboru konzoly Windows PowerShellu, který byl naposledy použit v aktuální relaci. Přepíše předchozí obsah souboru.

Pokud jste během aktuální relace neexportovali soubor konzoly, zobrazí se výzva, abyste mohli pokračovat, a pak se zobrazí výzva k zadání názvu souboru.

Příklad 3: Přidání modulu snap-in a export názvů modulů snap-in

Add-PSSnapin NewPSSnapin
Export-Console -path NewPSSnapinConsole.psc1
powershell.exe -PsConsoleFile NewPsSnapinConsole.psc1

Tyto příkazy přidají modul snap-in NewPSSnapin modulu snap-in Windows PowerShellu do aktuální relace, exportují názvy modulů snap-in Windows PowerShellu v aktuální relaci do souboru konzoly a potom spustí relaci Prostředí Windows PowerShell se souborem konzoly.

První příkaz použije rutinu Add-PSSnapin k přidání modulu snap-in NewPSSnapin do aktuální relace. Můžete přidat jenom moduly snap-in Windows PowerShellu, které jsou zaregistrované ve vašem systému.

Druhý příkaz exportuje názvy modulů snap-in windows PowerShellu do souboru NewPSSnapinConsole.psc1.

Třetí příkaz spustí Windows PowerShell se souborem NewPSSnapinConsole.psc1. Protože soubor konzoly obsahuje název modulu snap-in Prostředí Windows PowerShell, jsou rutiny a zprostředkovatelé v modulu snap-in k dispozici v aktuální relaci.

Příklad 4: Export názvů modulů snap-in do zadaného umístění

PS C:\> export-console -path Console01
PS C:\> notepad console01.psc1
<?xml version="1.0" encoding="utf-8"?>
<PSConsoleFile ConsoleSchemaVersion="1.0">
  <PSVersion>2.0</PSVersion>
  <PSSnapIns>
     <PSSnapIn Name="NewPSSnapin" />
  </PSSnapIns>
</PSConsoleFile>

Tento příkaz exportuje názvy modulů snap-in prostředí Windows PowerShell v aktuální relaci do souboru Console01.psc1 v aktuálním adresáři.

Druhý příkaz zobrazí obsah souboru Console01.psc1 v Poznámkovém bloku.

Příklad 5: Určení souboru konzoly, který se má aktualizovat

powershell.exe -PSConsoleFile Console01.psc1
Add-PSSnapin MySnapin
Export-Console NewConsole.psc1
$ConsoleFileName
Add-PSSnapin SnapIn03
Export-Console

Tento příklad ukazuje, jak pomocí $ConsoleFileName automatické proměnné určit soubor konzoly, který se aktualizuje, pokud použijete Export-Console bez hodnoty parametru Path.

První příkaz používá PSConsoleFile parametr PowerShell.exe k otevření Windows PowerShellu se souborem Console01.psc1.

Druhý příkaz používá rutinu Add-PSSnapin k přidání modulu snap-in MySnapin windows PowerShellu do aktuální relace.

Třetí příkaz používá rutinu Export-Console k exportu názvů všech modulů snap-in windows PowerShellu v relaci do souboru NewConsole.psc1.

Čtvrtý příkaz zobrazí proměnnou $ConsoleFileName. Obsahuje naposledy použitý soubor konzoly. Ukázkový výstup ukazuje, že NewConsole.ps1 je naposledy použitý soubor.

Pátý příkaz přidá SnapIn03 do aktuální konzoly.

Šestý příkaz používá rutinu Export-Console bez parametru Path. Tento příkaz exportuje názvy všech modulů snap-in windows PowerShellu v aktuální relaci do naposledy použitého souboru NewConsole.psc1.

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

Označuje, že tato rutina přepíše data v souboru konzoly bez upozornění, i když má soubor atribut jen pro čtení. Atribut jen pro čtení se změní a po dokončení příkazu se neobnoví.

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

-NoClobber

Označuje, že tato rutina nepřepíše existující soubor konzoly. Ve výchozím nastavení platí, že pokud se soubor vyskytuje v zadané cestě, Export-Console přepíše soubor bez upozornění.

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

-Path

Určuje cestu a název souboru konzoly (*.psc1). Zadejte volitelnou cestu a název. Zástupné znaky nejsou povoleny.

Pokud zadáte jenom název souboru, Export-Console vytvoří soubor s tímto názvem a příponou názvu souboru .psc1 v aktuálním adresáři.

Tento parametr se vyžaduje, pokud jste neotevřeli Prostředí Windows PowerShell s parametrem PSConsoleFile nebo jste během aktuální relace exportovali soubor konzoly. Je také nutné, když použijete parametr NoClobber, aby se zabránilo přepsání aktuálního souboru konzoly.

Pokud tento parametr vynecháte, Export-Console přepíše soubor konzoly, který byl použit naposledy v této relaci. Cesta k naposledy použitému souboru konzoly je uložena v hodnotě $ConsoleFileName automatické proměnné. Další informace naleznete v tématu about_Automatic_Variables.

Typ:String
Aliasy:PSPath
Position:0
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
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

K této rutině můžete převést řetězec cesty.

Výstupy

FileInfo

Tato rutina vytvoří soubor, který obsahuje exportované aliasy.

Poznámky

  • Když se ke spuštění relace použije soubor konzoly (.psc1), název souboru konzoly se automaticky uloží do $ConsoleFileName automatické proměnné. Hodnota $ConsoleFileName se aktualizuje při použití parametru PathExport-Console k zadání nového souboru konzoly. Pokud se nepoužívá žádný soubor konzoly, $ConsoleFileName nemá žádnou hodnotu ($null).

    Pokud chcete v nové relaci použít soubor konzoly Windows PowerShellu, spusťte Windows PowerShell pomocí následující syntaxe:

    powershell.exe -PsConsoleFile \<ConsoleFile\>.psc1

    Moduly snap-in Windows PowerShellu můžete uložit také pro budoucí relace přidáním příkazu Add-PSSnapin do profilu Prostředí Windows PowerShell. Další informace najdete v tématu about_Profiles.