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 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.psc1To 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-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
Add-PSSnapin NewPSSnapin
Export-Console -path NewPSSnapinConsole.psc1
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 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ść 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-ConsoleW 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.
| 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 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.
| 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 po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie zostało uruchomione.
| 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 zmiennej automatycznej$ConsoleFileName. Wartość parametru$ConsoleFileNamejest aktualizowana w przypadku użycia parametru Path parametruExport-Consolew 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.
