Delen via

Export-Console

  • Referentie
Module:
Microsoft.PowerShell.Core

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

Syntaxis

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 bestand ConsoleS1.psc1 in de map Consoles van de windows PowerShell-installatiemap $pshome.

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

PS C:\> 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

PS C:\> Add-PSSnapin NewPSSnapin
PS C:\> Export-Console -path NewPSSnapinConsole.psc1
PS C:\> 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 cmdlet Add-PSSnapin 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 bestand NewPSSnapinConsole.psc1.

De derde opdracht start Windows PowerShell met het bestand NewPSSnapinConsole.psc1. 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 bestand Console01.psc1 weergegeven in Kladblok.

Voorbeeld 5: het consolebestand bepalen dat moet worden bijgewerkt

PS C:\> powershell.exe -PSConsoleFile Console01.psc1
PS C:\> Add-PSSnapin MySnapin
PS C:\> Export-Console NewConsole.psc1
PS C:\> $ConsoleFileName
PS C:\> Add-PSSnapin SnapIn03
PS C:\> 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 een parameterwaarde voor Pad.

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

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

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

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 cmdlet Export-Console 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.

Parameters

-Confirm

U wordt gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:SwitchParameter
Aliassen:cf
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren: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
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-NoClobber

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

Type:SwitchParameter
Aliassen:NoOverwrite
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren: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, maakt Export-Console 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 PSConsoleFile parameter 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, overschrijft Export-Console het consolebestand overschrijft 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
Aliassen:PSPath
Position:0
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-WhatIf

Toont wat er zou gebeuren als de cmdlet wordt uitgevoerd. De cmdlet wordt niet uitgevoerd.

Type:SwitchParameter
Aliassen:wi
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren: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 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_Profiles voor meer informatie.