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 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

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

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.

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 gebruikt 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 Windows PowerShell-module bevat, zijn de cmdlets en providers in de module beschikbaar in de huidige sessie.

Voorbeeld 4: Namen van modules naar een opgegeven locatie exporteren

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

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 zonder een path-parameterwaarde gebruiktExport-Console.

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

De tweede opdracht gebruikt de Add-PSSnapin cmdlet om de Windows PowerShell-module MySnapin 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
Required: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
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-NoClobber

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

Type:SwitchParameter
Aliases:NoOverwrite
Position:Named
Default value:None
Required:False
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 in de huidige map.

Deze parameter is vereist, tenzij u Windows PowerShell hebt geopend met de parameter PSConsoleFile of een consolebestand tijdens de huidige sessie hebt geëxporteerd. 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 meest recent 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
Required:False
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
Required: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 van $ConsoleFileName wordt 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 windows PowerShell-modules ook opslaan voor toekomstige sessies door een add-PSSnapin-opdracht toe te voegen aan uw Windows PowerShell-profiel. Zie about_Profiles voor meer informatie.