Dela via

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å 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 PSConsoleFile parametern 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 filen ConsoleS1.psc1 i mappen Konsoler i Windows PowerShell-installationsmappen $pshome.

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

PS C:\> Export-Console

Det här kommandot exporterar namnen på Windows PowerShell-snapin-moduler från den aktuella sessionen till Windows PowerShell-konsolfilen 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 fortsätta och sedan uppmanas du att ange ett filnamn.

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

PS C:\> Add-PSSnapin NewPSSnapin
PS C:\> Export-Console -path NewPSSnapinConsole.psc1
PS C:\> 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 Snapin-modulnamnen för Windows PowerShell till filen NewPSSnapinConsole.psc1.

Det tredje kommandot startar Windows PowerShell med filen NewPSSnapinConsole.psc1. Eftersom konsolfilen innehåller snapin-modulnamnet för Windows PowerShell ä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-modulerna i den aktuella sessionen till filen Console01.psc1 i den aktuella katalogen.

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

Exempel 5: Fastställa vilken konsolfil som ska uppdateras

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

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

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

Det andra kommandot använder cmdleten Add-PSSnapin för att lägga till snapin-modulen MySnapin Windows PowerShell 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 filen NewConsole.psc1.

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.

Typ:SwitchParameter
Alias:cf
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Force

Anger att den här cmdleten 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 har slutförts.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken: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 skriver Export-Console över filen utan varning.

Typ:SwitchParameter
Alias:NoOverwrite
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken: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 skapar Export-Console en fil med det namnet och filnamnstillägget .psc1 i den aktuella katalogen.

Den här parametern krävs om du inte har öppnat Windows PowerShell med PSConsoleFile parameter 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 skriver Export-Console över konsolfilen som användes senast 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.

Typ:String
Alias:PSPath
Position:0
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-WhatIf

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

Typ:SwitchParameter
Alias:wi
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken: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 för $ConsoleFileName uppdateras när du använder parametern Path i Export-Console 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.