Export-Console

Referentie

Module:: Microsoft.PowerShell.Core

Hiermee exporteert u de namen van modules in de huidige sessie naar een consolebestand.

Syntax

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

Description

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_PSSnapins voor meer informatie over Windows PowerShell modules.

Voorbeelden

Voorbeeld 1: De namen van modules in de huidige sessie exporteren

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

Met deze opdracht worden de namen van Windows PowerShell modules in de huidige sessie geëxporteerd naar het ConsoleS1.psc1 bestand in de map Consoles van de Windows PowerShell installatiemap, $pshome.

Voorbeeld 2: De namen van modules exporteren naar het meest recente consolebestand

Export-Console

Met deze opdracht worden de namen van Windows PowerShell modules van de huidige sessie geëxporteerd naar het Windows PowerShell consolebestand dat het laatst is gebruikt in de huidige sessie. De vorige bestandsinhoud 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.

Voorbeeld 3: Een module toevoegen en de namen van modules exporteren

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.

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

Voorbeeld 4: Namen van modules exporteren naar een opgegeven locatie

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 Console01.psc1 bestand weergegeven in Kladblok.

Voorbeeld 5: het consolebestand bepalen dat moet worden bijgewerkt

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 zonder de parameterwaarde Path gebruikt.

Met de eerste opdracht wordt de parameter PSConsoleFile van PowerShell.exe gebruikt om Windows PowerShell te openen met het Console01.psc1 bestand.

Met de tweede opdracht wordt de Add-PSSnapin cmdlet gebruikt om de Module MySnapin Windows PowerShell toe te voegen aan de huidige sessie.

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

Met de vierde opdracht wordt de $ConsoleFileName variabele 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 padparameter . Met deze opdracht worden de namen van alle Windows PowerShell modules in de huidige sessie geëxporteerd naar het laatst gebruikte bestand. NewConsole.psc1

Parameters

-Confirm

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

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

-Force

Geeft aan dat deze cmdlet de gegevens in een consolebestand zonder waarschuwing overschrijft, zelfs als het bestand het kenmerk Alleen-lezen heeft. Het kenmerk Alleen-lezen wordt gewijzigd en wordt niet opnieuw ingesteld wanneer de opdracht is voltooid.

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

-NoClobber

Geeft aan dat deze cmdlet geen bestaand consolebestand overschrijft. Als een bestand optreedt in het opgegeven pad, Export-Console overschrijft u het bestand standaard zonder waarschuwing.

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

-Path

Hiermee geeft u een pad en bestandsnaam voor het consolebestand (*.psc1). Voer een optioneel pad en een naam in. Jokertekens zijn niet toegestaan.

Als u alleen een bestandsnaam opgeeft, Export-Console maakt u een bestand met die naam en de extensie .psc1-bestandsnaam in de huidige map.

Deze parameter is vereist, tenzij u Windows PowerShell hebt geopend met de parameter PSConsoleFile of een consolebestand hebt geëxporteerd tijdens de huidige sessie. Het is ook vereist wanneer u de parameter NoClobber gebruikt om te voorkomen dat het huidige consolebestand wordt overschreven.

Als u deze parameter weglaat, Export-Console overschrijft u het consolebestand dat het laatst in deze sessie is gebruikt. Het pad van het laatst gebruikte consolebestand wordt opgeslagen in de waarde van de $ConsoleFileName automatische variabele. Zie about_Automatic_Variables voor meer informatie.

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

-WhatIf

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.

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

Invoerwaarden

String

U kunt een padtekenreeks doorsluisen naar deze cmdlet.

Uitvoerwaarden

FileInfo

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

Notities

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 wordt $ConsoleFileName bijgewerkt wanneer u de parameter Path gebruikt om Export-Console 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 ook Windows PowerShell modules opslaan voor toekomstige sessies door een Add-PSSnapin opdracht toe te voegen aan uw Windows PowerShell profiel. Zie about_Profiles voor meer informatie.