Export-Console

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 im 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

-Force

-NoClobber

-Path

-WhatIf

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-Parameter 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\>.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.

Ähnliche Themen

• Add-PSSnapin
• Get-PSSnapin
• Remove-PSSnapin