Export-Console

  • Referencia
Modul:
Microsoft.PowerShell.Core

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

Syntax

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

Description

A Export-Console 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 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 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

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 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 elindítja a Windows PowerShellt 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 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 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ömb.

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ét használja a Console01.psc1 Windows PowerShell fájllal való megnyitásához.

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 a 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
Required: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 lesz visszaállítva.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
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
Required:False
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. A helyettesítő karakterek nem engedélyezettek.

Ha csak egy fájlnevet ad meg, létrehoz egy fájlt, Export-Console 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 a Windows PowerShellt a PSConsoleFile paraméterrel nyitotta meg, vagy az aktuális munkamenet során exportált egy konzolfájlt. Akkor is szükség van rá, 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
Required:False
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
Required: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 az Elérési út paraméterrel Export-Console új konzolfájlt ad meg. 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

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