Export-Console

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

De Export-Console cmdlet exporteert de namen van de Windows PowerShell-modules in de huidige sessie naar een Windows PowerShell-consolebestand (.psc1). U kunt deze cmdlet gebruiken om de modules op te slaan voor gebruik in toekomstige sessies.

Als u de modules in het .psc1-consolebestand wilt toevoegen aan een sessie, start u Windows PowerShell (powershell.exe) op de opdrachtregel met behulp van Cmd.exe of een andere Windows PowerShell-sessie en gebruikt u vervolgens de parameter PSConsoleFile van powershell.exe om het consolebestand op te geven.

Zie about_PSSnapinsvoor meer informatie over Windows PowerShell-modules.

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

Met deze opdracht exporteert u de namen van Windows PowerShell-modules in de huidige sessie naar het ConsoleS1.psc1 bestand in de map Consoles van de windows PowerShell-installatiemap, $PSHOME.

Export-Console

Met deze opdracht exporteert u de namen van Windows PowerShell-modules van de huidige sessie naar het Windows PowerShell-consolebestand dat het laatst is gebruikt in de huidige sessie. De inhoud van het vorige bestand wordt overschreven.

Als u tijdens de huidige sessie geen consolebestand hebt geëxporteerd, wordt u gevraagd om toestemming om door te gaan en vervolgens om een bestandsnaam te vragen.

Add-PSSnapin NewPSSnapin
Export-Console -Path NewPSSnapinConsole.psc1
powershell.exe -PSConsoleFile NewPsSnapinConsole.psc1

Met deze opdrachten voegt u de module NewPSSnapin Windows PowerShell toe aan de huidige sessie, exporteert u de namen van Windows PowerShell-modules in de huidige sessie naar een consolebestand en start u vervolgens een Windows PowerShell-sessie met het consolebestand.

De eerste opdracht maakt gebruik van de Add-PSSnapin cmdlet om de module NewPSSnapin toe te voegen aan de huidige sessie. U kunt alleen Windows PowerShell-modules toevoegen die zijn geregistreerd op uw systeem.

Met de tweede opdracht worden de windows PowerShell-modulenamen geëxporteerd naar het NewPSSnapinConsole.psc1-bestand.

Met de derde opdracht wordt Windows PowerShell gestart met het NewPSSnapinConsole.psc1-bestand. Omdat het consolebestand de naam van de Windows PowerShell-module bevat, zijn de cmdlets en providers in de module beschikbaar in de huidige sessie.

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>

Met deze opdracht worden de namen van de Windows PowerShell-modules in de huidige sessie geëxporteerd naar het Console01.psc1-bestand in de huidige map.

Met de tweede opdracht wordt de inhoud van het bestand Console01.psc1 in Kladblok weergegeven.

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

In dit voorbeeld ziet u hoe u de $ConsoleFileName automatische variabele gebruikt om het consolebestand te bepalen dat wordt bijgewerkt als u Export-Console gebruikt zonder parameterwaarde path.

De eerste opdracht maakt gebruik van de PSConsoleFile parameter van powershell.exe om Windows PowerShell te openen met het Console01.psc1 bestand.

De tweede opdracht maakt gebruik van de Add-PSSnapin cmdlet om de Module MySnapin Windows PowerShell toe te voegen aan de huidige sessie.

De derde opdracht maakt gebruik van de Export-Console cmdlet om de namen van alle Windows PowerShell-modules in de sessie te exporteren naar het NewConsole.psc1 bestand.

Met de vierde opdracht wordt de variabele $ConsoleFileName weergegeven. Het bevat het meest recent gebruikte consolebestand. In de voorbeelduitvoer ziet u dat NewConsole.ps1 het meest recent gebruikte bestand is.

Met de vijfde opdracht wordt SnapIn03 toegevoegd aan de huidige console.

De zesde opdracht maakt gebruik van de Export-Console cmdlet zonder een Path parameter. Met deze opdracht worden de namen van alle Windows PowerShell-modules in de huidige sessie geëxporteerd naar het laatst gebruikte bestand, NewConsole.psc1.

Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.

U kunt een padtekenreeks doorsluizen naar deze cmdlet.

Met deze cmdlet maakt u een bestand dat de geëxporteerde aliassen bevat.

• Wanneer een consolebestand (.psc1) wordt gebruikt om de sessie te starten, wordt de naam van het consolebestand automatisch opgeslagen in de $ConsoleFileName automatische variabele. De waarde van $ConsoleFileName wordt bijgewerkt wanneer u de parameter Pad van Export-Console gebruikt om een nieuw consolebestand op te geven. Wanneer er geen consolebestand wordt gebruikt, heeft $ConsoleFileName geen waarde ($null).

  Als u een Windows PowerShell-consolebestand in een nieuwe sessie wilt gebruiken, gebruikt u de volgende syntaxis om Windows PowerShell te starten:

  powershell.exe -PSConsoleFile <ConsoleFile>.psc1

  U kunt windows PowerShell-modules ook opslaan voor toekomstige sessies door een Add-PSSnapin opdracht toe te voegen aan uw Windows PowerShell-profiel. Zie about_Profilesvoor meer informatie.