Export-Console

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

Syntax

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

Description

Rutina Export-Console exportuje názvy modulů snap-in Windows PowerShell v aktuální relaci do souboru konzoly Windows PowerShell (.psc1). Tuto rutinu můžete použít k uložení modulů snap-in pro použití v budoucích relacích.

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

Další informace o Windows PowerShell modulu snap-in 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 Windows PowerShell v aktuální relaci do ConsoleS1.psc1 souboru ve složce Konzoly instalační složky 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 Windows PowerShell z aktuální relace do souboru konzoly Windows PowerShell, který byl naposledy použit v aktuální relaci. Přepíše předchozí obsah souboru.

Pokud jste během aktuální relace nevyexportovali 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 Windows PowerShell do aktuální relace, exportují názvy modulů snap-in Windows PowerShell v aktuální relaci do souboru konzoly a pak spustí relaci 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 PowerShell zaregistrované ve vašem systému.

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

Třetí příkaz spustí Windows PowerShell se souboremNewPSSnapinConsole.psc1. Protože soubor konzoly obsahuje název modulu snap-in Windows PowerShell, jsou rutiny a poskytovatelé 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 Windows PowerShell v aktuální relaci do Console01.psc1 souboru v aktuálním adresáři.

Druhý příkaz zobrazí obsah Console01.psc1 souboru 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á parametr PSConsoleFile PowerShell.exe k otevření Windows PowerShell se souboremConsole01.psc1.

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

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

Č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 Windows PowerShell snap-inů v aktuální relaci do naposledy použitého souboru. NewConsole.psc1

Parametry

-Confirm

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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters: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í.

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

-NoClobber

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

Type:SwitchParameter
Aliases:NoOverwrite
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters: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ří se 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 Windows PowerShell pomocí parametru PSConsoleFile nebo exportovali soubor konzoly během aktuální relace. 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, přepíše soubor konzoly použitý Export-Console naposledy v této relaci. Cesta k naposledy použitému souboru konzoly je uložena v hodnotě $ConsoleFileName automatické proměnné. Další informace najdete v tématu about_Automatic_Variables.

Type:String
Aliases:PSPath
Position:0
Default value:None
Accept pipeline input:True
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
Accept pipeline input:False
Accept wildcard characters:False

Vstupy

String

K této rutině můžete roušit ř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 Export-ConsoleCesta 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 PowerShell, spusťte Windows PowerShell pomocí následující syntaxe:

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

    Moduly snap-in Windows PowerShell můžete také uložit pro budoucí relace tak, že do profilu Windows PowerShell přidáte příkaz Add-PSSnapin. Další informace najdete v tématu about_Profiles.