Export-Console

  • Referenz
Modul:
Microsoft.PowerShell.Core

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 Export-Console Cmdlet 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: Exportieren der Namen von Snap-Ins in der aktuellen Sitzung

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

Mit diesem Befehl werden die Namen von Windows PowerShell-Snap-Ins in der aktuellen Sitzung in die ConsoleS1.psc1 Datei im Ordner "Konsolen" des Windows PowerShell-Installationsordners exportiert. $pshome

Beispiel 2: Exportieren der Namen von Snap-Ins in die neueste Konsolendatei

Export-Console

Dieser 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

Add-PSSnapin NewPSSnapin
Export-Console -path NewPSSnapinConsole.psc1
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 Add-PSSnapin Cmdlet, um das NewPSSnapin-Snap-In zur 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 Windows PowerShell-Snap-In-Namen 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>

Mit diesem Befehl werden die Namen der Windows PowerShell-Snap-Ins in der aktuellen Sitzung in die Console01.psc1 Datei im aktuellen Verzeichnis exportiert.

Der zweite Befehl zeigt den Inhalt der Console01.psc1 Datei in Editor an.

Beispiel 5: Ermitteln der zu aktualisierenden Konsolendatei

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

In diesem Beispiel wird gezeigt, wie $ConsoleFileName Die automatische Variable verwendet wird, um die Konsolendatei zu ermitteln, die aktualisiert wird, wenn Sie ohne path-Parameterwert verwendenExport-Console.

Der erste Befehl verwendet den PSConsoleFile-Parameter von PowerShell.exe, um Windows PowerShell mit der Console01.psc1 Datei zu öffnen.

Der zweite Befehl verwendet das Add-PSSnapin Cmdlet, um das Windows PowerShell-Snap-In "MySnapin" zur aktuellen Sitzung hinzuzufügen.

Der dritte Befehl verwendet das Export-Console Cmdlet, um die Namen aller Windows PowerShell-Snap-Ins in der Sitzung in die NewConsole.psc1 Datei zu exportieren.

Der vierte Befehl zeigt die $ConsoleFileName Variable 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 Export-Console Cmdlet ohne Path-Parameter. Mit diesem Befehl werden die Namen aller Windows PowerShell-Snap-Ins in der aktuellen Sitzung in die zuletzt verwendete Datei exportiert. NewConsole.psc1

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 wird nicht zurückgesetzt, wenn der Befehl abgeschlossen ist.

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

-NoClobber

Gibt an, dass dieses Cmdlet keine vorhandene Konsolendatei überschreibt. Wenn eine Datei im angegebenen Pfad auftritt, Export-Console wird die Datei standardmäßig ohne Warnung überschrieben.

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, Export-Console wird eine Datei mit diesem Namen und der Dateinamenerweiterung PSC1 im aktuellen Verzeichnis erstellt.

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 die Konsolendatei, Export-Console 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 about_Automatic_Variables.

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

String

Sie können eine Pfadzeichenfolge an dieses Cmdlet weiterleiten.

Ausgaben

FileInfo

Mit diesem Cmdlet wird eine Datei erstellt, 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 wird $ConsoleFileName aktualisiert, wenn Sie den Path-ParameterExport-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\>.psc1

    Sie 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.