Export-Console

Eksportuje nazwy przystawek w bieżącej sesji do pliku konsoli.

Składnia

Export-Console
      [[-Path] <String>]
      [-Force]
      [-NoClobber]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Opis

Polecenie Export-Console cmdlet eksportuje nazwy przystawek Windows PowerShell w bieżącej sesji do pliku konsoli Windows PowerShell (psc1). To polecenie cmdlet służy do zapisywania przystawek do użycia w przyszłych sesjach.

Aby dodać przystawki w pliku konsoli psc1 do sesji, uruchom Windows PowerShell (PowerShell.exe) w wierszu polecenia przy użyciu Cmd.exe lub innej sesji Windows PowerShell, a następnie użyj parametru PSConsoleFile PowerShell.exe, aby określić plik konsoli.

Aby uzyskać więcej informacji na temat przystawki Windows PowerShell, zobacz about_PSSnapins.

Przykłady

Przykład 1. Eksportowanie nazw przystawek w bieżącej sesji

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

To polecenie eksportuje nazwy Windows PowerShell przystawki w bieżącej sesji do ConsoleS1.psc1 pliku w folderze Konsole folderu instalacji Windows PowerShell , $pshome.

Przykład 2. Eksportowanie nazw przystawek do najnowszego pliku konsoli

Export-Console

To polecenie eksportuje nazwy Windows PowerShell przystawki z bieżącej sesji do pliku konsoli Windows PowerShell, który był ostatnio używany w bieżącej sesji. Zastępuje poprzednią zawartość pliku.

Jeśli plik konsoli nie został wyeksportowany podczas bieżącej sesji, zostanie wyświetlony monit o pozwolenie na kontynuowanie, a następnie monit o podanie nazwy pliku.

Przykład 3. Dodawanie przystawki i eksportowanie nazw przystawek

Add-PSSnapin NewPSSnapin
Export-Console -path NewPSSnapinConsole.psc1
powershell.exe -PsConsoleFile NewPsSnapinConsole.psc1

Te polecenia dodają przystawkę NewPSSnapin Windows PowerShell do bieżącej sesji, wyeksportuj nazwy przystawki Windows PowerShell w bieżącej sesji do pliku konsoli, a następnie uruchom Windows PowerShell sesji z plikiem konsoli.

Pierwsze polecenie używa Add-PSSnapin polecenia cmdlet , aby dodać przystawkę NewPSSnapin do bieżącej sesji. Można dodawać tylko Windows PowerShell przystawki zarejestrowane w systemie.

Drugie polecenie eksportuje nazwy przystawki Windows PowerShell do NewPSSnapinConsole.psc1 pliku.

Trzecie polecenie uruchamia Windows PowerShell z plikiem NewPSSnapinConsole.psc1 . Ponieważ plik konsoli zawiera Windows PowerShell nazwę przystawki, polecenia cmdlet i dostawcy w przystawce są dostępne w bieżącej sesji.

Przykład 4. Eksportowanie nazw przystawek do określonej lokalizacji

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>

To polecenie eksportuje nazwy przystawki Windows PowerShell w bieżącej sesji do Console01.psc1 pliku w bieżącym katalogu.

Drugie polecenie wyświetla zawartość pliku w Notatniku Console01.psc1 .

Przykład 5. Określanie pliku konsoli do zaktualizowania

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

W tym przykładzie pokazano, jak używać zmiennej automatycznej $ConsoleFileName do określenia pliku konsoli, który zostanie zaktualizowany, jeśli zostanie użyta Export-Console bez wartości parametru Ścieżka .

Pierwsze polecenie używa parametru PSConsoleFile PowerShell.exe, aby otworzyć Windows PowerShell z plikiemConsole01.psc1.

Drugie polecenie używa Add-PSSnapin polecenia cmdlet , aby dodać przystawkę MySnapin Windows PowerShell do bieżącej sesji.

Trzecie polecenie używa Export-Console polecenia cmdlet do wyeksportowania nazw wszystkich Windows PowerShell przystawki w sesji do NewConsole.psc1 pliku.

Czwarte polecenie wyświetla zmienną $ConsoleFileName . Zawiera on ostatnio używany plik konsoli. Przykładowe dane wyjściowe pokazują, że NewConsole.ps1 jest ostatnio używanym plikiem.

Piąte polecenie dodaje przystawkę SnapIn03 do bieżącej konsoli.

Szóste polecenie używa Export-Console polecenia cmdlet bez parametru Path . To polecenie eksportuje nazwy wszystkich Windows PowerShell przystawki w bieżącej sesji do ostatnio używanego pliku . NewConsole.psc1

Parametry

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

Wskazuje, że to polecenie cmdlet zastępuje dane w pliku konsoli bez ostrzeżenia, nawet jeśli plik ma atrybut tylko do odczytu. Atrybut tylko do odczytu jest zmieniany i nie jest resetowany po zakończeniu polecenia.

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

-NoClobber

Wskazuje, że to polecenie cmdlet nie zastępuje istniejącego pliku konsoli. Domyślnie, jeśli plik występuje w określonej ścieżce, Export-Console zastępuje plik bez ostrzeżenia.

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

-Path

Określa ścieżkę i nazwę pliku konsoli (*.psc1). Wprowadź opcjonalną ścieżkę i nazwę. Symbole wieloznaczne nie są dozwolone.

Jeśli określisz tylko nazwę pliku, Export-Console program tworzy plik o tej nazwie i rozszerzenie nazwy pliku psc1 w bieżącym katalogu.

Ten parametr jest wymagany, chyba że otwarto Windows PowerShell z parametrem PSConsoleFile lub wyeksportowano plik konsoli podczas bieżącej sesji. Jest to również wymagane w przypadku użycia parametru NoClobber , aby zapobiec zastępowaniu bieżącego pliku konsoli.

Jeśli pominiesz ten parametr, Export-Console zastąpi plik konsoli, który był ostatnio używany w tej sesji. Ścieżka ostatnio używanego pliku konsoli jest przechowywana w wartości $ConsoleFileName zmiennej automatycznej. Aby uzyskać więcej informacji, zobacz about_Automatic_Variables.

Type:String
Aliases:PSPath
Position:0
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie zostało uruchomione.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False

Dane wejściowe

String

Możesz przekazać ciąg ścieżki do tego polecenia cmdlet.

Dane wyjściowe

FileInfo

To polecenie cmdlet tworzy plik zawierający wyeksportowane aliasy.

Uwagi

  • Gdy plik konsoli (.psc1) jest używany do uruchamiania sesji, nazwa pliku konsoli jest automatycznie przechowywana w zmiennej automatycznej $ConsoleFileName . Wartość $ConsoleFileName jest aktualizowana podczas używania parametru Path w Export-Console celu określenia nowego pliku konsoli. Jeśli plik konsoli nie jest używany, $ConsoleFileName nie ma wartości ($null).

    Aby użyć pliku konsoli Windows PowerShell w nowej sesji, użyj następującej składni, aby rozpocząć Windows PowerShell:

    powershell.exe -PsConsoleFile \<ConsoleFile\>.psc1

    Można również zapisać przystawki Windows PowerShell dla przyszłych sesji, dodając polecenie Add-PSSnapin do profilu Windows PowerShell. Aby uzyskać więcej informacji, zobacz about_Profiles.