Export-Console
Exportiert die Namen von Snap-Ins in der aktuellen Sitzung in eine Konsolendatei.
Syntax
Export-Console
[[-Path] <String>]
[-Force]
[-NoClobber]
[-WhatIf]
[-Confirm]
[<CommonParameters>]Beschreibung
Das Cmdlet Export-Console exportiert die Namen der Windows PowerShell-Snap-Ins in der aktuellen Sitzung in eine Windows PowerShell-Konsolendatei (.psc1). Sie können dieses Cmdlet verwenden, um die Snap-Ins für die Verwendung in zukünftigen Sitzungen zu speichern.
Um die Snap-Ins in der PSC1-Konsolendatei zu einer Sitzung hinzuzufügen, starten Sie Windows PowerShell (Powershell.exe) über die Befehlszeile, indem Sie Cmd.exe oder eine andere Windows PowerShell Sitzung verwenden, und verwenden Sie dann den PSConsoleFile-Parameter von Powershell.exe, um die Konsolendatei anzugeben.
Weitere Informationen zu Windows PowerShell-Snap-Ins finden Sie unter „about_PSSnapins“.
Beispiele
Beispiel 1: Exportieren der Namen von Snap-Ins in der aktuellen Sitzung
PS C:\> Export-Console -Path $pshome\Consoles\ConsoleS1.psc1Dieser Befehl exportiert die Namen Windows PowerShell Snap-Ins in der aktuellen Sitzung in die Datei ConsoleS1.psc1 im Ordner Consoles des Windows PowerShell Installationsordners $pshome.
Beispiel 2: Exportieren der Namen von Snap-Ins in die neueste Konsolendatei
PS C:\> Export-ConsoleDieser Befehl exportiert die Namen der Windows PowerShell-Snap-Ins aus der aktuellen Sitzung in die Windows PowerShell-Konsolendatei, die in der aktuellen Sitzung zuletzt verwendet wurde. Der vorherige Dateiinhalt wird überschrieben.
Wenn Sie in der aktuellen Sitzung keine Konsolendatei exportiert haben, werden Sie vor dem Fortfahren zur Bestätigung und dann zur Eingabe eines Dateinamens aufgefordert.
Beispiel 3: Hinzufügen eines Snap-Ins und Exportieren der Namen von Snap-Ins
PS C:\> Add-PSSnapin NewPSSnapin
PS C:\> Export-Console -path NewPSSnapinConsole.psc1
PS C:\> powershell.exe -PsConsoleFile NewPsSnapinConsole.psc1Diese Befehle fügen das Windows PowerShell-Snap-In „NewPSSnapin“ zur aktuellen Sitzung hinzu, exportieren die Namen der Windows PowerShell-Snap-Ins in der aktuellen Sitzung in eine Konsolendatei und starten dann eine Windows PowerShell-Sitzung mit der Konsolendatei.
Der erste Befehl verwendet das Cmdlet Add-PSSnapin , um das NewPSSnapin-Snap-In der aktuellen Sitzung hinzuzufügen. Sie können nur Windows PowerShell-Snap-Ins hinzufügen, die in Ihrem System registriert sind.
Der zweite Befehl exportiert die Namen der Windows PowerShell-Snap-Ins in die NewPSSnapinConsole.psc1-Datei.
Der dritte Befehl startet Windows PowerShell mit der NewPSSnapinConsole.psc1-Datei. Da die Konsolendatei den Namen des Windows PowerShell-Snap-Ins enthält, sind die Cmdlets und Anbieter im Snap-In in der aktuellen Sitzung verfügbar.
Beispiel 4: Exportieren von Namen von Snap-Ins an einen angegebenen Speicherort
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>Dieser Befehl exportiert die Namen der Windows PowerShell-Snap-Ins in der aktuellen Sitzung in die Datei „Console01.psc1“ im aktuellen Verzeichnis.
Der zweite Befehl zeigt den Inhalt der Console01.psc1-Datei im Editor an.
Beispiel 5: Bestimmen der zu aktualisierenden Konsolendatei
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-ConsoleIn diesem Beispiel wird gezeigt, wie Sie die $ConsoleFileName automatische Variable verwenden, um die Konsolendatei zu bestimmen, die aktualisiert wird, wenn Sie Export-Console ohne Path-Parameterwert verwenden.
Der erste Befehl verwendet den PSConsoleFile-Parameter von PowerShell.exe, um Windows PowerShell mit der Datei Console01.psc1 zu öffnen.
Der zweite Befehl verwendet das Add-PSSnapin-Cmdlet, um der aktuellen Sitzung das Snap-In MySnapin Windows PowerShell hinzuzufügen.
Der dritte Befehl verwendet das Cmdlet Export-Console, um die Namen aller Windows PowerShell Snap-Ins in der Sitzung in die Datei NewConsole.psc1 zu exportieren.
Der vierte Befehl zeigt die variable $ConsoleFileName an. Sie enthält die zuletzt verwendete Konsolendatei. Die Beispielausgabe zeigt, dass NewConsole.ps1 die zuletzt verwendete Datei ist.
Der fünfte Befehl fügt „SnapIn03“ zur aktuellen Konsole hinzu.
Der sechste Befehl verwendet das Cmdlet Export-Console ohne Path-Parameter . Mit diesem Befehl werden die Namen aller Windows PowerShell-Snap-Ins in der aktuellen Sitzung in die zuletzt verwendete Datei (NewConsole.psc1) exportiert.
Parameter
-Confirm
Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Force
Gibt an, dass dieses Cmdlet die Daten in einer Konsolendatei ohne Warnung überschreibt, auch wenn die Datei über das schreibgeschützte Attribut verfügt. Das schreibgeschützte Attribut wird geändert und nach Abschluss des Befehls nicht zurückgesetzt.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-NoClobber
Gibt an, dass dieses Cmdlet eine vorhandene Konsolendatei nicht überschreibt. Wenn eine Datei im angegebenen Pfad auftritt, überschreibt Export-Console die Datei standardmäßig ohne Warnung.
| Type: | SwitchParameter |
| Aliases: | NoOverwrite |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Path
Gibt einen Pfad und Dateinamen für die Konsolendatei (*.psc1) an. Geben Sie einen optionalen Pfad und Namen ein. Platzhalterzeichen sind nicht zulässig.
Wenn Sie nur einen Dateinamen angeben, erstellt Export-Console eine Datei mit diesem Namen und der Dateinamenerweiterung .psc1 im aktuellen Verzeichnis.
Dieser Parameter ist erforderlich, es sei denn, Sie haben Windows PowerShell mit dem PSConsoleFile-Parameter geöffnet oder eine Konsolendatei während der aktuellen Sitzung exportiert. Dies ist auch erforderlich, wenn Sie den NoClobber-Parameter verwenden, um zu verhindern, dass die aktuelle Konsolendatei überschrieben wird.
Wenn Sie diesen Parameter weglassen, überschreibt Export-Console die Konsolendatei, die zuletzt in dieser Sitzung verwendet wurde. Der Pfad der zuletzt verwendeten Konsolendatei wird im Wert der $ConsoleFileName automatischen Variablen gespeichert. Weitere Informationen finden Sie unter %%amp;quot;about_Automatic_Variables%%amp;quot;.
| Type: | String |
| Aliases: | PSPath |
| Position: | 0 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-WhatIf
Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Eingaben
Sie können eine Pfadzeichenfolge an dieses Cmdlet übergeben.
Ausgaben
Dieses Cmdlet erstellt eine Datei, die die exportierten Aliase enthält.
Hinweise
Wenn eine Konsolendatei (.psc1) zum Starten der Sitzung verwendet wird, wird der Name der Konsolendatei automatisch in der automatischen $ConsoleFileName-Variablen gespeichert. Der Wert von $ConsoleFileName wird aktualisiert, wenn Sie den Path-Parameter von Export-Console verwenden, um eine neue Konsolendatei anzugeben. Wenn keine Konsolendatei verwendet wird, hat $ConsoleFileName keinen Wert ($Null).
Um eine Windows PowerShell-Konsolendatei in einer neuen Sitzung zu verwenden, starten Sie Windows PowerShell mit der folgenden Syntax:
powershell.exe -PsConsoleFile \<ConsoleFile\>.psc1Sie können Windows PowerShell-Snap-Ins auch für zukünftige Sitzungen speichern, indem Sie einen Add-PSSnapin-Befehl zu Ihrem Windows PowerShell-Profil hinzufügen. Weitere Informationen finden Sie unter „about_Profiles“.