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 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
K této rutině můžete převést řetězec cesty.
Výstupy
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í parametruExport-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.
Související odkazy
Váš názor
https://aka.ms/ContentUserFeedback.
Připravujeme: V průběhu roku 2024 budeme postupně vyřazovat problémy z GitHub coby mechanismus zpětné vazby pro obsah a nahrazovat ho novým systémem zpětné vazby. Další informace naleznete v tématu:Odeslat a zobrazit názory pro