Export-Console

Exportálja az aktuális munkamenetben lévő beépülő modulok nevét egy konzolfájlba.

Syntax

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

Description

A Export-Console parancsmag az aktuális munkamenet Windows PowerShell beépülő moduljainak nevét exportálja egy Windows PowerShell konzolfájlba (.psc1). Ezzel a parancsmaggal mentheti a beépülő modulokat a későbbi munkamenetekben való használatra.

Ha a .psc1 konzolfájlban lévő beépülő modulokat hozzá szeretné adni egy munkamenethez, indítsa el Windows PowerShell (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.

Az 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 munkamenet Windows PowerShell beépülő moduljainak nevét a ConsoleS1.psc1 Windows PowerShell telepítési mappájának Konzolok mappájában lévő fájlba. $pshome

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

Export-Console

Ez a parancs exportálja 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

Add-PSSnapin NewPSSnapin
Export-Console -path NewPSSnapinConsole.psc1
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 munkamenet Windows PowerShell beépülő moduljainak nevét egy konzolfájlba, majd elindítanak egy Windows PowerShell munkamenetet a konzolfájllal.

Az első parancs a Add-PSSnapin parancsmag használatával adja hozzá a NewPSSnapin beépülő modult az aktuális munkamenethez. Csak a rendszeren regisztrált Windows PowerShell beépülő modulokat adhat hozzá.

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

A harmadik parancs Windows PowerShell kezd a NewPSSnapinConsole.psc1 fájllal. 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 nevének 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 munkamenet Windows PowerShell beépülő moduljainak nevét az Console01.psc1 aktuális könyvtárban lévő fájlba.

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

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

powershell.exe -PSConsoleFile Console01.psc1
Add-PSSnapin MySnapin
Export-Console NewConsole.psc1
$ConsoleFileName
Add-PSSnapin SnapIn03
Export-Console

Ez a példa bemutatja, hogyan határozhatja meg az $ConsoleFileName automatikus változót annak a konzolfájlnak a meghatározásához, amelyet akkor fog frissíteni, ha path paraméterérték nélkül használjaExport-Console.

Az első parancs a PowerShell.exe PSConsoleFile paraméterével nyitja meg Windows PowerShell 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 változót $ConsoleFileName . 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 elérési út paraméter nélkül használja a Export-Console parancsmagot. Ez a parancs exportálja az aktuális munkamenet összes Windows PowerShell beépülő moduljának nevét a legutóbb használt fájlba. NewConsole.psc1

Paraméterek

-Confirm

Jóváhagyást kér a parancsmag futtatása előtt.

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

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters: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-Console figyelmeztetés nélkül felülírja a fájlt.

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

-Path

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

Ha csak egy fájlnevet ad meg, Export-Console az aktuális könyvtárban létrehoz egy ilyen nevű fájlt és a .psc1 fájlnévkiterjesztést.

Ez a paraméter csak akkor szükséges, ha megnyitotta Windows PowerShell a PSConsoleFile paraméterrel, vagy exportált egy konzolfájlt az aktuális munkamenet során. Akkor is szükséges, ha a NoClobber paramétert használja az aktuális konzolfájl felülírásának megakadályozásához.

Ha kihagyja ezt a paramétert, Export-Console 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.

Type:String
Aliases:PSPath
Position:0
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

Bemutatja, mi történne a parancsmag futtatásakor. A parancsmag nem fut.

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

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 az $ConsoleFileName automatikus változóban lesz tárolva. Az érték $ConsoleFileName akkor frissül, ha a Path paraméterrel Export-Console új konzolfájlt ad meg. Ha nem használ konzolfájlt, $ConsoleFileName nincs értéke ($null).

    Ha Windows PowerShell konzolfájlt szeretne használni egy új munkamenetben, az alábbi szintaxissal kezdje el Windows PowerShell:

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

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