Export-Console
Exportiert die Namen von Snap-Ins in der aktuellen Sitzung in eine Konsolendatei.
Syntax
Default (Standard)
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 Cmd.exe oder eine andere Windows PowerShell-Sitzung auf der Befehlszeile, 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
PS> export-console -path $pshome\Consoles\ConsoleS1.psc1
Mit diesem Befehl werden die Namen von Windows PowerShell-Snap-Ins in der aktuellen Sitzung in die Datei "ConsoleS1.psc1" im Unterverzeichnis der Windows PowerShell-Installation $pshome exportiert.
Beispiel 2
PS> export-console
Dieser Befehl exportiert die Namen von Windows PowerShell-Snap-Ins aus der aktuellen Sitzung in die Windows PowerShell-Konsolendatei, die zuletzt in der aktuellen Sitzung verwendet wurde. Er überschreibt den vorherigen Dateiinhalt.
Wenn Sie während der aktuellen Sitzung keine Konsolendatei exportiert haben, werden Sie aufgefordert, den Vorgang fortzusetzen, und dann zur Eingabe eines Dateinamens aufgefordert.
Beispiel 3
PS> add-pssnapin NewPSSnapin
PS> export-console -path NewPSSnapinConsole.psc1
PS> powershell.exe -PsConsoleFile NewPsSnapinConsole.psc1
Diese Befehle fügen das NewPSSnapin Windows PowerShell-Snap-In zur aktuellen Sitzung hinzu, exportieren die Namen von Windows PowerShell-Snap-Ins in der aktuellen Sitzung in eine Konsolendatei, und starten Sie dann eine Windows PowerShell-Sitzung mit der Konsolendatei.
Der erste Befehl verwendet das Cmdlet Add-PSSnapin, um das NewPSSnapin-Snap-In zur aktuellen Sitzung hinzuzufügen. Sie können nur Windows PowerShell-Snap-Ins hinzufügen, die auf Ihrem System registriert sind.
Der zweite Befehl exportiert die Windows PowerShell-Snap-In-Namen in die Datei NewPSSnapinConsole.psc1.
Der dritte Befehl startet Windows PowerShell mit der Datei NewPSSnapinConsole.psc1. Da die Konsolendatei den Windows PowerShell-Snap-In-Namen enthält, sind die Cmdlets und Anbieter im Snap-In in der aktuellen Sitzung verfügbar.
Beispiel 4
PS> export-console -path Console01
PS> notepad console01.psc1
<?xml version="1.0" encoding="utf-8"?>
<PSConsoleFile ConsoleSchemaVersion="1.0">
<PSVersion>2.0</PSVersion>
<PSSnapIns>
<PSSnapIn Name="NewPSSnapin" />
</PSSnapIns>
</PSConsoleFile>
Mit diesem Befehl werden die Namen der Windows PowerShell-Snap-Ins in der aktuellen Sitzung in die Datei "Console01.psc1" im aktuellen Verzeichnis exportiert.
Der zweite Befehl zeigt den Inhalt der Datei "Console01.psc1" im Editor an.
Beispiel 5
PS> powershell.exe -PSConsoleFile Console01.psc1
PS> add-pssnapin MySnapin
PS> export-console NewConsole.psc1
PS> $consolefilename
PS> add-pssnapin SnapIn03
PS> export-console
In diesem Beispiel wird gezeigt, wie Sie die $ConsoleFileName automatische Variable verwenden, um die Konsolendatei zu ermitteln, die aktualisiert wird, wenn Sie Export-Console ohne Einen 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 cmdlet Add-PSSnapin, um das Windows PowerShell-Snap-In MySnapin zur aktuellen Sitzung 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 verwendet den parameter $ConsoleFileName, um die zuletzt verwendete Konsolendatei anzuzeigen. Die Beispielausgabe zeigt, dass NewConsole.ps1 die zuletzt verwendete Datei ist.
Der fünfte Befehl fügt SnapIn03 der aktuellen Konsole hinzu.
Der sechste Befehl verwendet das Cmdlet ExportConsole 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
Fordert Sie zur Bestätigung auf, bevor Sie das Cmdlet ausführen.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | False |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
| Aliase: | vgl |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Force
Überschreibt die Daten in einer Konsolendatei ohne Warnung, auch wenn die Datei über das schreibgeschützte Attribut verfügt. Das schreibgeschützte Attribut wird geändert und wird nicht zurückgesetzt, wenn der Befehl abgeschlossen ist.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-NoClobber
Überschreiben (ersetzen Sie den Inhalt) einer vorhandenen Konsolendatei nicht. Wenn eine Datei im angegebenen Pfad vorhanden ist, überschreibt Export-Console die Datei standardmäßig ohne Warnung.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
| Aliase: | NoOverwrite |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Path
Gibt einen Pfad und Dateinamen für die Konsolendatei (*.psc1) an. Geben Sie einen Pfad (optional) und einen Namen ein. Platzhalter sind nicht zulässig.
Wenn Sie nur einen Dateinamen eingeben, 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 PARAMETER "PSConsoleFile" geöffnet oder während der aktuellen Sitzung eine Konsolendatei exportiert. Es ist auch erforderlich, wenn Sie den Parameter NoClobber 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, überschrieben (ersetzt den Inhalt). Der Pfad zur zuletzt verwendeten Konsolendatei wird im Wert der $ConsoleFileName automatischen Variablen gespeichert. Weitere Informationen finden Sie unter about_Automatic_Variables.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
| Aliase: | PSPath |
Parametersätze
(All)
| Position: | 1 |
| Obligatorisch: | False |
| Wert aus Pipeline: | True |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
-WhatIf
Zeigt, was passiert, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | False |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
| Aliase: | Wi |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
CommonParameters
Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.
Eingaben
String
Sie können eine Pfadzeichenfolge an "Export-Console" übergeben.
Ausgaben
FileInfo
Export-Console 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 $ConsoleFileName automatischen 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, verwenden Sie die folgende Syntax, um Windows PowerShell zu starten:
"powershell.exe -PsConsoleFile <ConsoleFile.psc1>".
Sie können Windows PowerShell-Snap-Ins auch für zukünftige Sitzungen speichern, indem Sie Ihrem Windows PowerShell-Profil einen Add-PSSnapin Befehl hinzufügen. Weitere Informationen finden Sie unter about_Profiles.