Export-Console

  • Odwołanie
Moduł:
Microsoft.PowerShell.Core

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 programu Windows PowerShell w bieżącej sesji do pliku konsoli programu 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 program Windows PowerShell (PowerShell.exe) w wierszu polecenia przy użyciu Cmd.exe lub innej sesji programu Windows PowerShell, a następnie użyj parametru PSConsoleFile PowerShell.exe, aby określić plik konsoli.

Aby uzyskać więcej informacji na temat przystawek programu 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 przystawek programu Windows PowerShell w bieżącej sesji do ConsoleS1.psc1 pliku w folderze Konsole folderu instalacyjnego programu Windows PowerShell, $pshome.

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

Export-Console

To polecenie eksportuje nazwy przystawek programu Windows PowerShell z bieżącej sesji do pliku konsoli programu Windows PowerShell, który był ostatnio używany w bieżącej sesji. Zastępuje on 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 programu Windows PowerShell do bieżącej sesji, wyeksportuj nazwy przystawek programu Windows PowerShell w bieżącej sesji do pliku konsoli, a następnie uruchom sesję programu Windows PowerShell z plikiem konsoli.

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

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

Trzecie polecenie uruchamia program Windows PowerShell z plikiem NewPSSnapinConsole.psc1 . Ponieważ plik konsoli zawiera nazwę przystawki programu Windows PowerShell, 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 przystawek programu Windows PowerShell w bieżącej sesji do Console01.psc1 pliku w bieżącym katalogu.

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

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żyć zmiennej automatycznej $ConsoleFileName w celu określenia pliku konsoli, który zostanie zaktualizowany w przypadku użycia Export-Console bez wartości parametru Ścieżka .

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

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

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

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

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

Szóste polecenie używa Export-Console polecenia cmdlet bez parametru Path . To polecenie eksportuje nazwy wszystkich przystawek programu Windows PowerShell 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
Required: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
Required:False
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
Required:False
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 utworzy plik, który ma tę nazwę i rozszerzenie nazwy pliku psc1 w bieżącym katalogu.

Ten parametr jest wymagany, chyba że program Windows PowerShell został otwarty z parametrem PSConsoleFile lub wyeksportował plik konsoli podczas bieżącej sesji. Jest to również wymagane, gdy używasz parametru NoClobber , aby zapobiec zastępowaniu bieżącego pliku konsoli.

Jeśli ten parametr zostanie pominięty, 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 zmiennej automatycznej $ConsoleFileName. Aby uzyskać więcej informacji, zobacz about_Automatic_Variables.

Type:String
Aliases:PSPath
Position:0
Default value:None
Required:False
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
Required: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ść parametru $ConsoleFileName jest aktualizowana w przypadku użycia parametru Path parametru Export-Console w celu określenia nowego pliku konsoli. Jeśli nie jest używany żaden plik konsoli, $ConsoleFileName nie ma wartości ($null).

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

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

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