Export-Console

  • Reference
Modul:
Microsoft.PowerShell.Core

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 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 prostředí 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 snap-inech Windows PowerShellu 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 ConsoleS1.psc1 souboru 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 Prostředí Windows PowerShell 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 pomocí rutiny Add-PSSnapin přidá modul 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 NewPSSnapinConsole.psc1 do souboru.

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 Console01.psc1 souboru v aktuálním adresáři.

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

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 PowerShellu se souborem Console01.psc1 .

Druhý příkaz pomocí rutiny Add-PSSnapin přidá modul 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 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 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 zobrazí výzvu k potvrzení.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required: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
Required:False
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 dojde k souboru v zadané cestě, Export-Console přepíše soubor bez upozornění.

Type:SwitchParameter
Aliases:NoOverwrite
Position:Named
Default value:None
Required:False
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 pouze název souboru, vytvoří se soubor s Export-Console 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 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, přepíše soubor konzoly, Export-Console 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 najdete v tématu about_Automatic_Variables.

Type:String
Aliases:PSPath
Position:0
Default value:None
Required:False
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
Required:False
Accept pipeline input:False
Accept wildcard characters: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 Export-Console Cesta 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 také uložit pro budoucí relace přidáním příkazu Add-PSSnapin do profilu Windows PowerShellu. Další informace najdete v tématu about_Profiles.