Export-Console
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 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-installationsmappen, $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 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
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-modulnamnen NewPSSnapinConsole.psc1
till filen.
Det tredje kommandot startar Windows PowerShell med NewPSSnapinConsole.psc1
filen. 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 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 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 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 en sökvägsparameter . 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 Export-Console
skriver du som standard över filen utan förvarning.
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 Export-Console
skapar du 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 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 den konsolfil 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ördes. 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
Du kan skicka en sökvägssträng till den här cmdleten.
Utdata
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 parameternExport-Console
Sö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.