Sdílet prostřednictvím

Export-Console

Modul:
Microsoft.PowerShell.Core Module

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

Syntax

Default (Výchozí) 

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 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 cmdletu vás vyzve k potvrzení.

Vlastnosti parametru

Typ:SwitchParameter
Default value:False
Podporuje zástupné znaky:False
DontShow:False
Aliasy:viz

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů: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í.

Vlastnosti parametru

Typ:SwitchParameter
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů: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í.

Vlastnosti parametru

Typ:SwitchParameter
Default value:None
Podporuje zástupné znaky:False
DontShow:False
Aliasy:NoOverwrite

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů: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é. Viz about_Automatic_Variablespro více informací.

Vlastnosti parametru

Typ:String
Default value:None
Podporuje zástupné znaky:False
DontShow:False
Aliasy:PSPath

Sady parametrů

(All)
Position:0
Povinné:False
Hodnota z kanálu:True
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů:False

-WhatIf

Ukazuje, co se stane, když se příkaz spustí. Příkazový modul nebyl spuštěn.

Vlastnosti parametru

Typ:SwitchParameter
Default value:False
Podporuje zástupné znaky:False
DontShow:False
Aliasy:Wi

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

CommonParameters

Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.

Vstupy

String

Můžete odeslat řetězec cesty do této rutiny cmdlet.

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.