Save-Help
Pobiera i zapisuje najnowsze pliki pomocy w katalogu systemu plików.
Składnia
Path (domyślnie)
Save-Help
[-DestinationPath] <String[]>
[[-Module] <PSModuleInfo[]>]
[[-UICulture] <CultureInfo[]>]
[-FullyQualifiedModule <ModuleSpecification[]>]
[-Credential <PSCredential>]
[-UseDefaultCredentials]
[-Force]
[<CommonParameters>]
LiteralPath
Save-Help
[[-Module] <PSModuleInfo[]>]
[[-UICulture] <CultureInfo[]>]
-LiteralPath <String[]>
[-FullyQualifiedModule <ModuleSpecification[]>]
[-Credential <PSCredential>]
[-UseDefaultCredentials]
[-Force]
[<CommonParameters>]
Opis
Polecenie cmdlet Save-Help pobiera najnowsze pliki pomocy dla modułów programu PowerShell i zapisuje je w określonym katalogu. Ta funkcja umożliwia aktualizowanie plików pomocy na komputerach, które nie mają dostępu do Internetu, i ułatwia aktualizowanie plików pomocy na wielu komputerach.
W programie Windows PowerShell 3.0 Save-Help działały tylko dla modułów zainstalowanych na komputerze lokalnym. Chociaż można było zaimportować moduł z komputera zdalnego lub uzyskać odwołanie do obiektu PSModuleInfo z komputera zdalnego przy użyciu komunikacji zdalnej programu PowerShell, właściwość HelpInfoUri nie została zachowana, a Save-Help nie będzie działać w przypadku pomocy modułu zdalnego.
W programie Windows PowerShell 4.0 właściwość HelpInfoUri jest zachowywana za pośrednictwem komunikacji zdalnej programu PowerShell, co umożliwia zapisywania pomocy dla modułów zainstalowanych na komputerach zdalnych.
Istnieje również możliwość zapisania obiektu
Aby zainstalować zapisane pliki pomocy, uruchom polecenie cmdlet Update-Help. Dodaj parametr SourcePath, aby określić folder, w którym zapisano pliki Pomocy.
Bez parametrów polecenie Save-Help pobiera najnowszą pomoc dla wszystkich modułów w sesji oraz modułów zainstalowanych na komputerze w lokalizacji wymienionej w zmiennej środowiskowej PSModulePath. Ta akcja pomija moduły, które nie obsługują aktualizowalnej pomocy bez ostrzeżenia.
Polecenie cmdlet Save-Help sprawdza wersję wszystkich plików pomocy w folderze docelowym. Jeśli nowsze pliki pomocy są dostępne, to polecenie cmdlet pobiera najnowsze pliki pomocy z Internetu, a następnie zapisuje je w folderze. Polecenie cmdlet Save-Help działa podobnie jak polecenie cmdlet Update-Help, z tą różnicą, że zapisuje pobrane pliki cabinet (.cab) zamiast wyodrębniać pliki pomocy z plików cabinet i instalować je na komputerze.
Zapisana pomoc dla każdego modułu składa się z jednego pliku pomocy (HelpInfo XML) i pliku cabinet (.cab) dla plików pomocy każdej kultury interfejsu użytkownika. Nie trzeba wyodrębniać plików pomocy z pliku cabinet. Polecenie cmdlet Update-Help wyodrębnia pliki pomocy, weryfikuje kod XML pod kątem bezpieczeństwa, a następnie instaluje pliki pomocy i plik informacji pomocy w podfolderze specyficznym dla języka folderu modułu.
Aby zapisać pliki pomocy dla modułów w folderze instalacyjnym programu PowerShell ($pshome\Modules), uruchom program PowerShell przy użyciu opcji Uruchom jako administrator. Aby pobrać pliki pomocy dla tych modułów, musisz być członkiem grupy Administratorzy na komputerze.
To cmdlet zostało wprowadzone w Windows PowerShell 3.0.
Przykłady
Przykład 1. Zapisywanie pomocy dla modułu DhcpServer
# Option 1: Run Invoke-Command to get the PSModuleInfo object for the remote DHCP Server module, save the PSModuleInfo object in the variable $m, and then run Save-Help.
$m = Invoke-Command -ComputerName RemoteServer -ScriptBlock { Get-Module -Name DhcpServer -ListAvailable }
Save-Help -Module $m -DestinationPath "C:\SavedHelp"
# Option 2: Open a PSSession--targeted at the remote computer that is running the DhcpServer module--to get the PSModuleInfo object for the remote module, and then run Save-Help.
$s = New-PSSession -ComputerName "RemoteServer"
$m = Get-Module -PSSession $s -Name "DhcpServer" -ListAvailable
Save-Help -Module $m -DestinationPath "C:\SavedHelp"
# Option 3: Open a CIM session--targeted at the remote computer that is running the DhcpServer module--to get the PSModuleInfo object for the remote module, and then run Save-Help.
$c = New-CimSession -ComputerName "RemoteServer"
$m = Get-Module -CimSession $c -Name "DhcpServer" -ListAvailable
Save-Help -Module $m -DestinationPath "C:\SavedHelp"
W tym przykładzie przedstawiono trzy różne sposoby używania Save-Help w celu zapisania pomocy dla modułu DhcpServer z komputera klienckiego połączonego z Internetem bez instalowania modułu DhcpServer lub roli serwera DHCP na komputerze lokalnym.
Przykład 2. Instalowanie pomocy dotyczącej modułu DhcpServer
# First, run Export-CliXml to export the PSModuleInfo object to a shared folder or to removable media.
$m = Get-Module -Name "DhcpServer" -ListAvailable
Export-CliXml -Path "E:\UsbFlashDrive\DhcpModule.xml" -InputObject $m
# Next, transport the removable media to a computer that has Internet access, and then import the PSModuleInfo object with Import-CliXml. Run Save-Help to save the Help for the imported DhcpServer module PSModuleInfo object.
$deserialized_m = Import-CliXml "E:\UsbFlashDrive\DhcpModule.xml"
Save-Help -Module $deserialized_m -DestinationPath "E:\UsbFlashDrive\SavedHelp"
# Finally, transport the removable media back to the computer that does not have network access, and then install the help by running Update-Help.
Update-Help -Module DhcpServer -SourcePath "E:\UsbFlashDrive\SavedHelp"
W tym przykładzie pokazano, jak zainstalować pomoc zapisaną w przykładzie 1 dla modułu DhcpServer na komputerze, który nie ma dostępu do Internetu.
Przykład 3. Zapisywanie pomocy dla wszystkich modułów
Save-Help -DestinationPath "\\Server01\FileShare01"
To polecenie pobiera najnowsze pliki pomocy dla wszystkich modułów w kulturze interfejsu użytkownika ustawionego dla systemu Windows na komputerze lokalnym. Zapisuje pliki pomocy w folderze \\Server01\Fileshare01.
Przykład 4. Zapisywanie pomocy dotyczącej modułu na komputerze
Save-Help -Module ServerManager -DestinationPath "\\Server01\FileShare01" -Credential Domain01/Admin01
To polecenie pobiera najnowsze pliki pomocy dla modułu ServerManager, a następnie zapisuje je w folderze \\Server01\Fileshare01.
Po zainstalowaniu modułu na komputerze można wpisać nazwę modułu jako wartość parametru Module, nawet jeśli moduł nie zostanie zaimportowany do bieżącej sesji.
Polecenie używa parametru Credential, aby podać poświadczenia użytkownika, który ma uprawnienia do zapisu w udziale plików.
Przykład 5. Zapisywanie pomocy dotyczącej modułu na innym komputerze
Invoke-Command -ComputerName Server02 {Get-Module -Name CustomSQL -ListAvailable} | Save-Help -DestinationPath \\Server01\FileShare01 -Credential Domain01\Admin01
Te polecenia pobierają najnowsze pliki pomocy dla modułu CustomSQL i zapisują je w folderze \\Server01\Fileshare01.
Ponieważ moduł CustomSQL nie jest zainstalowany na komputerze, sekwencja zawiera polecenie Invoke-Command, które pobiera obiekt modułu dla modułu CustomSQL z komputera Server02, a następnie potokuje obiekt modułu do polecenia cmdlet Save-Help.
Jeśli moduł nie jest zainstalowany na komputerze, Save-Help wymaga obiektu modułu, który zawiera informacje o lokalizacji najnowszych plików pomocy.
Przykład 6. Zapisywanie pomocy dla modułu w wielu językach
Save-Help -Module Microsoft.PowerShell* -UICulture de-DE, en-US, fr-FR, ja-JP -DestinationPath "D:\Help"
To polecenie zapisuje pomoc dla modułów Programu PowerShell Core w czterech różnych kulturach interfejsu użytkownika. Pakiety językowe dla tych ustawień regionalnych nie muszą być zainstalowane na komputerze.
Save-Help może pobierać pliki pomocy dla modułów w różnych kulturach interfejsu użytkownika tylko wtedy, gdy właściciel modułu udostępnia przetłumaczone pliki w Internecie.
Przykład 7. Zapisywanie pomocy więcej niż raz dziennie
Save-Help -Force -DestinationPath "\\Server3\AdminShare\Help"
To polecenie zapisuje pomoc dla wszystkich modułów zainstalowanych na komputerze. Polecenie określa parametr Force, aby zastąpić regułę, która uniemożliwia polecenie cmdlet Save-Help pobierania pomocy więcej niż raz w każdym 24-godzinnym okresie.
Parametr Force zastępuje również ograniczenie 1 GB i pomija sprawdzanie wersji. W związku z tym można pobierać pliki, nawet jeśli wersja nie jest nowsza niż wersja w folderze docelowym.
Polecenie używa polecenia cmdlet Save-Help w celu pobrania i zapisania plików pomocy w określonym folderze. Parametr Force jest wymagany, gdy trzeba uruchomić polecenie Save-Help więcej niż raz dziennie.
Parametry
-Credential
Określa poświadczenia użytkownika. To polecenie cmdlet uruchamia polecenie przy użyciu poświadczeń użytkownika, który ma uprawnienia dostępu do lokalizacji systemu plików określonej przez parametr DestinationPath. Ten parametr jest prawidłowy tylko wtedy, gdy parametr DestinationPath lub LiteralPath jest używany w poleceniu .
Ten parametr umożliwia uruchamianie poleceń Save-Help, które używają parametru DestinationPath na komputerach zdalnych. Podając jawne poświadczenia, można uruchomić polecenie na komputerze zdalnym i uzyskać dostęp do udziału plików na trzecim komputerze bez napotkania błędu odmowy dostępu lub uwierzytelniania CredSSP w celu delegowania poświadczeń.
Właściwości parametru
| Typ: | PSCredential |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowe: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-DestinationPath
Określa ścieżkę folderu, w którym są zapisywane pliki pomocy. Nie należy określać nazwy pliku ani rozszerzenia nazwy pliku.
Właściwości parametru
| Typ: | String[] |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
Path
| Position: | 0 |
| Obowiązkowe: | True |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-Force
Wskazuje, że to polecenie cmdlet nie jest zgodne z ograniczeniem raz dziennie, pomija sprawdzanie wersji i pobiera pliki, które przekraczają limit 1 GB.
Bez tego parametru tylko jeden polecenie Save-Help dla każdego modułu jest dozwolone w każdym 24-godzinnym okresie, pobieranie jest ograniczone do 1 GB nieskompresowanej zawartości na moduł, a pliki pomocy dla modułu są instalowane tylko wtedy, gdy są nowsze niż pliki na komputerze.
Limit raz dziennie chroni serwery hostujące pliki pomocy i sprawia, że można dodać polecenie Save-Help do profilu programu PowerShell.
Aby zapisać pomoc dotyczącą modułu w wielu kulturach interfejsu użytkownika bez parametru Force, uwzględnij wszystkie kultury interfejsu użytkownika w tym samym poleceniu, takie jak: Save-Help -Module PSScheduledJobs -UICulture en-US, fr-FR, pt-BR
Właściwości parametru
| Typ: | SwitchParameter |
| Domyślna wartość: | False |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowe: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-FullyQualifiedModule
Określa moduły o nazwach, które są określone w postaci obiektów ModuleSpecification. Jest to opisane w sekcji Uwagi konstruktora ModuleSpecification (Hashtable) w bibliotece MSDN. Na przykład parametr FullyQualifiedModule akceptuje nazwę modułu określoną w formacie @{ModuleName = "modulename"; ModuleVersion = "version_number"} lub @{ModuleName = "modulename"; ModuleVersion = "version_number"; Guid = "GUID"}. ModuleName i ModuleVersion są wymagane, ale identyfikator GUID jest opcjonalny.
Nie można określić parametru
Właściwości parametru
| Typ: | ModuleSpecification[] |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowe: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | True |
| Wartość z pozostałych argumentów: | False |
-LiteralPath
Określa ścieżkę folderu docelowego. W przeciwieństwie do wartości parametru DestinationPath wartość parametru LiteralPath jest używana dokładnie tak, jak jest typowana. Żadne znaki nie są interpretowane jako symbole wieloznaczne. Jeśli ścieżka zawiera znaki ucieczki, należy ująć ją w pojedynczy cudzysłów. Pojedyncze cudzysłowy wskazują programowi PowerShell, aby nie interpretował żadnych znaków jako sekwencji ucieczki.
Właściwości parametru
| Typ: | String[] |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
| Aliasy: | PSPath |
Zestawy parametrów
LiteralPath
| Position: | Named |
| Obowiązkowe: | True |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-Module
Określa moduły, dla których to polecenie cmdlet pobiera pomoc. Wprowadź co najmniej jedną nazwę modułu lub patters nazw na liście rozdzielanej przecinkami lub w pliku, który ma jedną nazwę modułu w każdym wierszu. Symbole wieloznaczne są dozwolone. Możesz również potokować obiekty modułów z polecenia cmdlet Get-Module do Save-Help.
Domyślnie program Save-Help pobiera pomoc dla wszystkich modułów obsługujących aktualizowalną pomoc i są instalowane na komputerze lokalnym w lokalizacji wymienionej w zmiennej środowiskowej PSModulePath.
Aby zapisać pomoc dotyczącą modułów, które nie są zainstalowane na komputerze, uruchom polecenie Get-Module na komputerze zdalnym.
Następnie przekaż wynikowe obiekty modułu do polecenia cmdlet
Jeśli określony moduł jest zainstalowany na komputerze, możesz wprowadzić nazwę modułu lub obiekt modułu. Jeśli moduł nie jest zainstalowany na komputerze, należy wprowadzić obiekt modułu, taki jak jeden zwrócony przez polecenie cmdlet Get-Module.
Module parametr polecenia cmdlet Save-Help nie akceptuje pełnej ścieżki pliku modułu ani pliku manifestu modułu.
Aby zapisać pomoc dotyczącą modułu, który nie znajduje się w lokalizacji
Wartość "*" (wszystkie) próbuje zaktualizować pomoc dla wszystkich modułów zainstalowanych na komputerze. Obejmuje to moduły, które nie obsługują aktualizowalnej pomocy. Ta wartość może generować błędy, gdy polecenie napotka moduły, które nie obsługują aktualizowalnej pomocy.
Właściwości parametru
| Typ: | PSModuleInfo[] |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | True |
| DontShow: | False |
| Aliasy: | Nazwa |
Zestawy parametrów
(All)
| Position: | 1 |
| Obowiązkowe: | False |
| Wartość z potoku: | True |
| Wartość z potoku według nazwy właściwości: | True |
| Wartość z pozostałych argumentów: | False |
-UICulture
Określa wartości kultury interfejsu użytkownika, dla których to polecenie cmdlet pobiera zaktualizowane pliki pomocy. Wprowadź co najmniej jeden kod języka, taki jak es-ES, zmienna zawierająca obiekty kultury lub polecenie, które pobiera obiekty kultury, takie jak Get-Culture lub Get-UICulture polecenia.
Symbole wieloznaczne nie są dozwolone. Nie należy określać częściowego kodu języka, takiego jak "de".
Domyślnie Save-Help pobiera pliki pomocy w kulturze interfejsu użytkownika ustawionej dla systemu Windows lub jej kultury rezerwowej. W przypadku określenia parametru UICultureSave-Help szuka pomocy tylko dla określonej kultury interfejsu użytkownika, a nie w żadnej kulturze rezerwowej.
Właściwości parametru
| Typ: | CultureInfo[] |
| Domyślna wartość: | Current UI culture |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | 2 |
| Obowiązkowe: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-UseDefaultCredentials
Wskazuje, że to polecenie cmdlet uruchamia polecenie, w tym pobieranie internetowe, z poświadczeniami bieżącego użytkownika. Domyślnie polecenie jest uruchamiane bez jawnych poświadczeń.
Ten parametr jest skuteczny tylko wtedy, gdy pobieranie internetowe używa protokołu NTLM, negocjowania lub uwierzytelniania opartego na protokole Kerberos.
Właściwości parametru
| Typ: | SwitchParameter |
| Domyślna wartość: | False |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowe: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
CommonParameters
To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.
Dane wejściowe
PSModuleInfo
Obiekt modułu można przekazać potokiem z polecenia cmdlet Get-Module
Dane wyjściowe
None
To polecenie cmdlet nie generuje żadnych danych wyjściowych.
Uwagi
- Aby zapisać pomoc dotyczącą modułów w folderze $pshome\Modules, uruchom program PowerShell przy użyciu opcji Uruchom jako administrator. Tylko członkowie grupy Administratorzy na komputerze mogą pobrać pomoc dotyczącą modułów w folderze $pshome\Modules.
- Zapisana pomoc dla każdego modułu składa się z jednego pliku pomocy (HelpInfo XML) i pliku cabinet (.cab) dla plików pomocy każdej kultury interfejsu użytkownika. Nie trzeba wyodrębniać plików pomocy z pliku cabinet. Polecenie cmdlet Update-Help wyodrębnia pliki pomocy, weryfikuje kod XML, a następnie instaluje pliki pomocy i plik informacji pomocy w podfolderze specyficznym dla języka folderu modułu.
- Polecenie cmdlet Save-Help może zapisać pomoc dotyczącą modułów, które nie są zainstalowane na komputerze. Jednak ponieważ pliki pomocy są zainstalowane w folderze modułu, polecenie cmdlet Update-Help może zainstalować zaktualizowany plik pomocy tylko dla modułów zainstalowanych na komputerze.
- Jeśli Save-Help nie może odnaleźć zaktualizowanych plików pomocy dla modułu lub nie można odnaleźć zaktualizowanych plików pomocy w określonym języku, będzie ona kontynuowana w trybie dyskretnym bez wyświetlania komunikatu o błędzie. Aby sprawdzić, które pliki zostały zapisane przez polecenie, określ parametr Verbose.
- Moduły są najmniejszą jednostką aktualizowalnej pomocy. Nie można zapisać pomocy dla określonego polecenia cmdlet, tylko dla wszystkich poleceń cmdlet w module. Aby znaleźć moduł zawierający określone polecenie cmdlet, użyj właściwości ModuleName razem z poleceniem cmdlet Get-Command, na przykład
(Get-Command \<cmdlet-name\>).ModuleName - Save-Help obsługuje wszystkie moduły i przystawki PowerShell Core. Nie obsługuje żadnych innych przystawek.
- Polecenia cmdlet Update-Help i Save-Help pobierają pliki pomocy: port 80 dla protokołu HTTP i port 443 dla protokołu HTTPS.
- Polecenia cmdlet Update-Help i Save-Help nie są obsługiwane w środowisku preinstalacji systemu Windows (Windows PE).