Export-Console

Referens

Modul:: Microsoft.PowerShell.Core

Exporterar namnen på snapin-moduler i den aktuella sessionen till en konsolfil.

Syntax

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

Description

Cmdleten Export-Console exporterar namnen på de Windows PowerShell snapin-modulerna i den aktuella sessionen till en Windows PowerShell konsolfil (.psc1). Du kan använda den här cmdleten för att spara snapin-modulerna för användning i framtida sessioner.

Om du vill lägga till snapin-modulerna i .psc1-konsolfilen i en session startar du Windows PowerShell (PowerShell.exe) på kommandoraden med hjälp av Cmd.exe eller en annan Windows PowerShell session och använder sedan parametern PSConsoleFile för PowerShell.exe för att ange konsolfilen.

Mer information om Windows PowerShell snapin-moduler finns i about_PSSnapins.

Exempel

Exempel 1: Exportera namnen på snapin-moduler i den aktuella sessionen

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

Det här kommandot exporterar namnen på Windows PowerShell snapin-moduler i den aktuella sessionen till ConsoleS1.psc1 filen i mappen Konsoler i Windows PowerShell installationsmapp, $pshome.

Exempel 2: Exportera namnen på snapin-moduler till den senaste konsolfilen

Export-Console

Det här kommandot exporterar namnen på Windows PowerShell snapin-moduler från den aktuella sessionen till den Windows PowerShell konsolfil som senast användes i den aktuella sessionen. Det skriver över det tidigare filinnehållet.

Om du inte har exporterat en konsolfil under den aktuella sessionen uppmanas du att ange behörighet att fortsätta och sedan uppmanas att ange ett filnamn.

Exempel 3: Lägg till en snapin-modul och exportera namnen på snapin-moduler

Add-PSSnapin NewPSSnapin
Export-Console -path NewPSSnapinConsole.psc1
powershell.exe -PsConsoleFile NewPsSnapinConsole.psc1

Dessa kommandon lägger till Snapin-modulen NewPSSnapin Windows PowerShell i den aktuella sessionen, exporterar namnen på Windows PowerShell snapin-moduler i den aktuella sessionen till en konsolfil och startar sedan en Windows PowerShell session med konsolfilen.

Det första kommandot använder cmdleten Add-PSSnapin för att lägga till snapin-modulen NewPSSnapin i den aktuella sessionen. Du kan bara lägga till Windows PowerShell snapin-moduler som är registrerade i systemet.

Det andra kommandot exporterar Windows PowerShell snapin-namn till NewPSSnapinConsole.psc1 filen.

Det tredje kommandot startar Windows PowerShell med NewPSSnapinConsole.psc1 filen. Eftersom konsolfilen innehåller Windows PowerShell snapin-modulnamn är cmdletarna och leverantörerna i snapin-modulen tillgängliga i den aktuella sessionen.

Exempel 4: Exportera namn på snapin-moduler till en angiven plats

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>

Det här kommandot exporterar namnen på Windows PowerShell snapin-moduler i den aktuella sessionen till Console01.psc1 filen i den aktuella katalogen.

Det andra kommandot visar innehållet i Console01.psc1 filen i Anteckningar.

Exempel 5: Fastställa vilken konsolfil som ska uppdateras

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

Det här exemplet visar hur du använder den $ConsoleFileName automatiska variabeln för att fastställa vilken konsolfil som ska uppdateras om du använder Export-Console utan parametervärdet Sökväg .

Det första kommandot använder parametern PSConsoleFile för PowerShell.exe för att öppna Windows PowerShell med Console01.psc1 filen.

Det andra kommandot använder cmdleten Add-PSSnapin för att lägga till MySnapin-Windows PowerShell snapin-modul i den aktuella sessionen.

Det tredje kommandot använder cmdleten Export-Console för att exportera namnen på alla Windows PowerShell snapin-moduler i sessionen till NewConsole.psc1 filen.

Det fjärde kommandot visar variabeln $ConsoleFileName . Den innehåller den senast använda konsolfilen. Exempelutdata visar att NewConsole.ps1 är den senast använda filen.

Det femte kommandot lägger till SnapIn03 i den aktuella konsolen.

Det sjätte kommandot använder cmdleten Export-Console utan parametern Path . Det här kommandot exporterar namnen på alla Windows PowerShell snapin-moduler i den aktuella sessionen till den senast använda filen, NewConsole.psc1.

Parametrar

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

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

-Force

Anger att denna cmdlet skriver över data i en konsolfil utan varning, även om filen har det skrivskyddade attributet. Det skrivskyddade attributet ändras och återställs inte när kommandot är klart.

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

-NoClobber

Anger att den här cmdleten inte skriver över en befintlig konsolfil. Om en fil inträffar i den angivna sökvägen Export-Console skriver du som standard över filen utan förvarning.

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

-Path

Anger en sökväg och ett filnamn för konsolfilen (*.psc1). Ange en valfri sökväg och ett namn. Jokertecken tillåts inte.

Om du bara anger ett filnamn Export-Console skapar du en fil som har det namnet och filnamnstillägget .psc1 i den aktuella katalogen.

Den här parametern krävs om du inte har öppnat Windows PowerShell med parametern PSConsoleFile eller exporterat en konsolfil under den aktuella sessionen. Det krävs också när du använder parametern NoClobber för att förhindra att den aktuella konsolfilen skrivs över.

Om du utelämnar den här parametern Export-Console skriver du över konsolfilen som senast användes i den här sessionen. Sökvägen till den senast använda konsolfilen lagras i värdet för den $ConsoleFileName automatiska variabeln. Mer information finns i about_Automatic_Variables.

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

-WhatIf

Visar vad som skulle hända om cmdleten kördes. Cmdleten körs inte.

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

Indata

String

Du kan skicka en sökvägssträng till den här cmdleten.

Utdata

FileInfo

Den här cmdleten skapar en fil som innehåller de exporterade aliasen.

Kommentarer

När en konsolfil (.psc1) används för att starta sessionen lagras namnet på konsolfilen automatiskt i den $ConsoleFileName automatiska variabeln. Värdet $ConsoleFileName för uppdateras när du använder parametern Export-ConsoleSökväg för för att ange en ny konsolfil. När ingen konsolfil används har $ConsoleFileName inget värde ($null).

Om du vill använda en Windows PowerShell-konsolfil i en ny session använder du följande syntax för att starta Windows PowerShell:

powershell.exe -PsConsoleFile \<ConsoleFile\>.psc1

Du kan också spara Windows PowerShell snapin-moduler för framtida sessioner genom att lägga till ett Add-PSSnapin kommando i din Windows PowerShell profil. Mer information finns i about_Profiles.