Megosztás a következőn keresztül:

Export-Console

Modul:
Microsoft.PowerShell.Core Module

Exportálja az aktuális munkamenet beépülő moduljainak nevét egy konzolfájlba.

Syntax

Default (Alapértelmezett) 

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

Description

Az Exportálási konzol parancsmag exportálja az aktuális munkamenetben lévő Windows PowerShell beépülő modulok nevét egy Windows PowerShell-konzolfájlba (.psc1). Ezzel a parancsmaggal mentheti a beépülő modulokat a későbbi munkamenetekben való használatra.

A .psc1 konzolfájl beépülő moduljainak munkamenethez való hozzáadásához indítsa el a Windows PowerShellt (Powershell.exe) a parancssorban Cmd.exe vagy egy másik Windows PowerShell-munkamenet használatával, majd a Powershell.exe PSConsoleFile paraméterével adja meg a konzolfájlt.

A Windows PowerShell beépülő modulokkal kapcsolatos további információkért lásd: about_PSSnapins.

Példák

1. példa: Beépülő modulok nevének exportálása az aktuális munkamenetben

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

Ez a parancs exportálja az aktuális munkamenetben lévő Windows PowerShell beépülő modulok nevét a Windows PowerShell telepítési mappa Konzolok mappájának ConsoleS1.psc1 fájljába, $pshome.

2. példa: Beépülő modulok nevének exportálása a legújabb konzolfájlba

PS C:\> Export-Console

Ez a parancs exportálja a Windows PowerShell beépülő modulok nevét az aktuális munkamenetből az aktuális munkamenetben legutóbb használt Windows PowerShell-konzolfájlba. Felülírja az előző fájl tartalmát.

Ha az aktuális munkamenet során nem exportált konzolfájlt, a rendszer engedélyt kér a folytatáshoz, majd egy fájlnév megadását kéri.

3. példa: Beépülő modul hozzáadása és a beépülő modulok nevének exportálása

PS C:\> Add-PSSnapin NewPSSnapin
PS C:\> Export-Console -path NewPSSnapinConsole.psc1
PS C:\> powershell.exe -PsConsoleFile NewPsSnapinConsole.psc1

Ezek a parancsok hozzáadják a NewPSSnapin Windows PowerShell beépülő modult az aktuális munkamenethez, exportálják az aktuális munkamenetben lévő Windows PowerShell beépülő modulok nevét egy konzolfájlba, majd elindítanak egy Windows PowerShell-munkamenetet a konzolfájllal.

Az első parancs a Add-PSSnapin parancsmaggal adja hozzá a NewPSSnapin beépülő modult az aktuális munkamenethez. Csak olyan Windows PowerShell-beépülő modulokat vehet fel, amelyek regisztrálva vannak a rendszeren.

A második parancs exportálja a Windows PowerShell beépülő modulneveket a NewPSSnapinConsole.psc1 fájlba.

A harmadik parancs a Windows PowerShellt a NewPSSnapinConsole.psc1 fájllal indítja el. Mivel a konzolfájl tartalmazza a Windows PowerShell beépülő modul nevét, a beépülő modul parancsmagjai és szolgáltatói az aktuális munkamenetben érhetők el.

4. példa: Beépülő modulok neveinek exportálása egy megadott helyre

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>

Ez a parancs exportálja az aktuális munkamenetBen lévő Windows PowerShell beépülő modulok nevét az aktuális könyvtár Console01.psc1 fájljába.

A második parancs megjeleníti a Console01.psc1 fájl tartalmát a Jegyzettömbben.

5. példa: A frissíteni kívánt konzolfájl meghatározása

PS C:\> powershell.exe -PSConsoleFile Console01.psc1
PS C:\> Add-PSSnapin MySnapin
PS C:\> Export-Console NewConsole.psc1
PS C:\> $ConsoleFileName
PS C:\> Add-PSSnapin SnapIn03
PS C:\> Export-Console

Ez a példa bemutatja, hogyan határozhatja meg a $ConsoleFileName automatikus változót a frissítendő konzolfájl meghatározásához, ha Export-ConsolePath paraméterérték nélkül használja.

Az első parancs a PowerShell.exe PSConsoleFile PSConsoleFile paraméterével nyitja meg a Windows PowerShellt a Console01.psc1 fájllal.

A második parancs a Add-PSSnapin parancsmaggal adja hozzá a MySnapin Windows PowerShell beépülő modult az aktuális munkamenethez.

A harmadik parancs a Export-Console parancsmaggal exportálja a munkamenet összes Windows PowerShell beépülő moduljának nevét a NewConsole.psc1 fájlba.

A negyedik parancs megjeleníti a $ConsoleFileName változót. A legutóbb használt konzolfájlt tartalmazza. A mintakimenet azt mutatja, hogy NewConsole.ps1 a legutóbb használt fájl.

Az ötödik parancs hozzáadja a SnapIn03-at az aktuális konzolhoz.

A hatodik parancs az Export-Console parancsmagot használja Elérési út paraméter nélkül. Ez a parancs exportálja az aktuális munkamenet összes Windows PowerShell beépülő moduljának nevét a legutóbb használt NewConsole.psc1 fájlba.

Paraméterek

-Confirm

Megerősítést kér a parancsmag futtatása előtt.

Paramétertulajdonságok

Típus:SwitchParameter
Alapértelmezett érték:False
Támogatja a helyettesítő karaktereket:False
DontShow:False
Aliasok:Cf

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

-Force

Azt jelzi, hogy ez a parancsmag figyelmeztetés nélkül felülírja a konzolfájl adatait, még akkor is, ha a fájl írásvédett attribútummal rendelkezik. Az írásvédett attribútum módosul, és a parancs befejeződésekor nem lesz visszaállítva.

Paramétertulajdonságok

Típus:SwitchParameter
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

-NoClobber

Azt jelzi, hogy ez a parancsmag nem írja felül a meglévő konzolfájlt. Alapértelmezés szerint, ha egy fájl a megadott elérési úton történik, Exportálási konzol figyelmeztetés nélkül felülírja a fájlt.

Paramétertulajdonságok

Típus:SwitchParameter
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False
Aliasok:NoOverwrite

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

-Path

Megadja a konzolfájl elérési útját és fájlnevét (*.psc1). Adjon meg egy választható elérési utat és nevet. A helyettesítő karakterek nem engedélyezettek.

Ha csak egy fájlnevet ad meg, Exportálási konzol létrehoz egy fájlt, amelynek a neve és a .psc1 fájlnévkiterjesztés az aktuális könyvtárban található.

Ez a paraméter csak akkor szükséges, ha megnyitotta a Windows PowerShellt a PSConsoleFile paraméterrel, vagy exportált egy konzolfájlt az aktuális munkamenet során. A NoClobber paraméter használatakor is szükség van rá, hogy az aktuális konzolfájl ne legyen felülírva.

Ha kihagyja ezt a paramétert, exportálási konzol felülírja a munkamenetben legutóbb használt konzolfájlt. A legutóbb használt konzolfájl elérési útja a $ConsoleFileName automatikus változó értékében van tárolva. További információ: about_Automatic_Variables.

Paramétertulajdonságok

Típus:String
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False
Aliasok:PSPath

Paraméterkészletek

(All)
Position:0
Kötelező:False
Folyamatból származó érték:True
Folyamatból származó érték tulajdonságnév alapján:True
Fennmaradó argumentumokból származó érték:False

-WhatIf

Megjeleníti, mi történne, ha a parancsmag futna. A parancsmag nem fut.

Paramétertulajdonságok

Típus:SwitchParameter
Alapértelmezett érték:False
Támogatja a helyettesítő karaktereket:False
DontShow:False
Aliasok:Wi

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

CommonParameters

Ez a parancsmag a következő gyakori paramétereket támogatja: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction és -WarningVariable. További információért lásd about_CommonParameters.

Bevitelek

String

Ehhez a parancsmaghoz egy elérésiút-sztringet is beszúrhat.

Kimenetek

FileInfo

Ez a parancsmag létrehoz egy fájlt, amely tartalmazza az exportált aliasokat.

Jegyzetek

  • Amikor egy konzolfájlt (.psc1) használ a munkamenet elindításához, a konzolfájl neve automatikusan a $ConsoleFileName automatikus változóban lesz tárolva. A $ConsoleFileName értéke akkor frissül, ha a Export-ConsolePath paraméterét használja egy új konzolfájl megadásához. Ha nem használ konzolfájlt, $ConsoleFileName nincs értéke ($Null).

    Windows PowerShell-konzolfájl új munkamenetben való használatához használja az alábbi szintaxist a Windows PowerShell elindításához:

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

    Windows PowerShell beépülő modulokat is menthet a későbbi munkamenetekhez, ha hozzáad egy Add-PSSnapin parancsot a Windows PowerShell-profiljához. További információ: about_Profiles.