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 cmdlet Export-Console 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 PSConsoleFile parametru 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.psc1To polecenie eksportuje nazwy przystawek programu Windows PowerShell w bieżącej sesji do pliku ConsoleS1.psc1 w folderze Konsole folderu instalacyjnego programu Windows PowerShell, $pshome.
Przykład 2. Eksportowanie nazw przystawek do najnowszego pliku konsoli
PS C:\> Export-ConsoleTo 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
PS C:\> Add-PSSnapin NewPSSnapin
PS C:\> Export-Console -path NewPSSnapinConsole.psc1
PS C:\> powershell.exe -PsConsoleFile NewPsSnapinConsole.psc1Te 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 polecenia cmdlet Add-PSSnapin, 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 pliku NewPSSnapinConsole.psc1.
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 pliku Console01.psc1 w bieżącym katalogu.
Drugie polecenie wyświetla zawartość pliku Console01.psc1 w Notatniku.
Przykład 5. Określanie pliku konsoli do zaktualizowania
PS C:\> powershell.exe -PSConsoleFile Console01.psc1
PS C:\> Add-PSSnapin MySnapin
PS C:\> Export-Console NewConsole.psc1
PS C:\> $ConsoleFileName
PS C:\> Add-PSSnapin SnapIn03
PS C:\> Export-ConsoleW tym przykładzie pokazano, jak użyć zmiennej automatycznej $ConsoleFileName w celu określenia pliku konsoli, który zostanie zaktualizowany, jeśli używasz Export-Console bez wartości parametru Path.
Pierwsze polecenie używa parametru PSConsoleFile PowerShell.exe, aby otworzyć program Windows PowerShell z plikiem Console01.psc1.
Drugie polecenie używa polecenia cmdlet Add-PSSnapin, aby dodać przystawkę Programu Windows PowerShell MySnapin do bieżącej sesji.
Trzecie polecenie używa polecenia cmdlet Export-Console w celu wyeksportowania nazw wszystkich przystawek programu Windows PowerShell w sesji do pliku NewConsole.psc1.
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 polecenia cmdlet Export-Console 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.
| Typ: | SwitchParameter |
| Aliasy: | cf |
| Position: | Named |
| Domyślna wartość: | False |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | 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.
| Typ: | SwitchParameter |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | 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.
| Typ: | SwitchParameter |
| Aliasy: | NoOverwrite |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | 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 tworzy plik o tej nazwie i rozszerzeniu 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 w przypadku używania 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.
| Typ: | String |
| Aliasy: | PSPath |
| Position: | 0 |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-WhatIf
Pokazuje, co się stanie, jeśli polecenie cmdlet zostanie uruchomione. Polecenie cmdlet nie jest uruchamiane.
| Typ: | SwitchParameter |
| Aliasy: | wi |
| Position: | Named |
| Domyślna wartość: | False |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
Dane wejściowe
Możesz przekazać ciąg ścieżki do tego polecenia cmdlet.
Dane wyjściowe
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 $ConsoleFileName zmiennej automatycznej. Wartość $ConsoleFileName jest aktualizowana podczas używania parametru path
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\>.psc1Przystawki 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.