Update-Help

Odwołanie

Moduł:: Microsoft.PowerShell.Core

Pobiera i instaluje najnowsze pliki pomocy na komputerze.

Składnia

Update-Help
      [[-Module] <String[]>]
      [-FullyQualifiedModule <ModuleSpecification[]>]
      [[-SourcePath] <String[]>]
      [-Recurse]
      [[-UICulture] <CultureInfo[]>]
      [-Credential <PSCredential>]
      [-UseDefaultCredentials]
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Update-Help
      [[-Module] <String[]>]
      [-FullyQualifiedModule <ModuleSpecification[]>]
      [-LiteralPath <String[]>]
      [-Recurse]
      [[-UICulture] <CultureInfo[]>]
      [-Credential <PSCredential>]
      [-UseDefaultCredentials]
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Opis

Polecenie cmdlet Update-Help pobiera najnowsze pliki pomocy dla modułów programu PowerShell i instaluje je na komputerze. Nie musisz ponownie uruchamiać programu PowerShell, aby wprowadzić zmianę w życie. Aby natychmiast wyświetlić nowe pliki pomocy, możesz użyć polecenia cmdlet Get-Help.

Update-Help sprawdza wersję plików pomocy na komputerze. Jeśli nie masz plików pomocy dla modułu lub jeśli pliki pomocy są nieaktualne, Update-Help pobiera najnowsze pliki pomocy. Pliki pomocy można pobrać i zainstalować z Internetu lub udziału plików.

Bez parametrów Update-Help aktualizować pliki pomocy dla modułów w sesji i dla wszystkich zainstalowanych modułów obsługujących aktualizowalną pomoc. Uwzględnione są moduły zainstalowane, ale nie załadowane w bieżącej sesji. Moduły programu PowerShell są przechowywane w lokalizacji wymienionej w zmiennej środowiskowej $env:PSModulePath. Aby uzyskać więcej informacji, zobacz about_Updatable_Help.

Możesz użyć parametru module , aby zaktualizować pliki pomocy dla określonego modułu. Użyj parametru UICulture, aby pobrać pliki pomocy w wielu językach i ustawieniach regionalnych.

Można użyć Update-Help na komputerach, które nie są połączone z Internetem. Użyj polecenia cmdlet Save-Help, aby pobrać pliki pomocy z Internetu i zapisać je w lokalizacji systemu plików, takiej jak folder udostępniony lub katalog systemu plików. Następnie użyj parametru SourcePathUpdate-Help, aby pobrać zaktualizowane pliki pomocy z lokalizacji systemu plików i zainstalować je na komputerze.

Aktualizacje pomocy można zautomatyzować, dodając polecenie cmdlet Update-Help do profilu programu PowerShell. Domyślnie Update-Help uruchamia tylko jeden raz dziennie na każdym komputerze. Aby zastąpić limit raz dziennie, użyj parametru Force.

Polecenie cmdlet Update-Help zostało wprowadzone w programie Windows PowerShell 3.0.

Ważny

Update-Help wymaga uprawnień administracyjnych.

Aby zaktualizować pliki pomocy dla modułów PowerShell Core, musisz być członkiem grupy Administratorzy na komputerze.

Aby pobrać lub zaktualizować pliki pomocy dla modułów w katalogu instalacyjnym programu PowerShell ($PSHOME\Modules), w tym moduły programu PowerShell Core, uruchom program PowerShell przy użyciu opcji Uruchom jako administrator. Na przykład: Start-Process powershell.exe -Verb RunAs.

Pliki pomocy można również zaktualizować przy użyciu elementu menu Update Windows PowerShell Help (Aktualizowanie programu Windows PowerShell) w menu Pomoc w zintegrowanym środowisku skryptów programu Windows PowerShell (ISE).

Element Pomocy programu Windows PowerShell update uruchamia polecenie cmdlet Update-Help bez parametrów. Aby zaktualizować pomoc dotyczącą modułów w katalogu $PSHOME, uruchom program Windows PowerShell ISE przy użyciu opcji Uruchom jako administrator.

Przykłady

Przykład 1. Aktualizowanie plików pomocy dla wszystkich modułów

Polecenie cmdlet Update-Help aktualizuje pliki pomocy dla zainstalowanych modułów, które obsługują pomoc z możliwością aktualizacji. Język kultury interfejsu użytkownika jest ustawiany w systemie operacyjnym.

Update-Help

Przykład 2. Aktualizowanie plików pomocy dla określonych modułów

Polecenie cmdlet Update-Help aktualizuje pliki pomocy tylko dla nazw modułów rozpoczynających się od Microsoft.PowerShell.

Update-Help -Module Microsoft.PowerShell*

Przykład 3. Aktualizowanie plików pomocy dla różnych języków

Polecenie cmdlet Update-Help aktualizuje pliki pomocy języka japońskiego (ja-JP) i angielskiego (en-US) dla wszystkich modułów.

Jeśli moduł nie udostępnia plików pomocy dla określonej kultury interfejsu użytkownika, zostanie wyświetlony komunikat o błędzie dla kultury modułu i interfejsu użytkownika. W tym przykładzie komunikat o błędzie wskazuje, że pliki pomocy ja-JP nie zostały znalezione dla modułu Microsoft.PowerShell.Utility.

Update-Help -UICulture ja-JP, en-US

Update-Help : Failed to update Help for the module(s) 'Microsoft.PowerShell.Utility' with UI culture(s) {ja-JP}
No UI culture was found that matches the following pattern: ja-JP.

Przykład 4. Automatyczne aktualizowanie plików pomocy

W tym przykładzie jest tworzone zaplanowane zadanie, które aktualizuje pomoc dla wszystkich modułów codziennie o godzinie 3:00.

$jobParams = @{
  Name = 'UpdateHelpJob'
  Credential = 'Domain01\User01'
  ScriptBlock = '{Update-Help}'
  Trigger = (New-JobTrigger -Daily -At "3 AM")
}
Register-ScheduledJob @jobParams

Id         Name            JobTriggers     Command                                  Enabled
--         ----            -----------     -------                                  -------
1          UpdateHelpJob   1               Update-Help                              True

Polecenie cmdlet Register-ScheduledJob tworzy zaplanowane zadanie uruchamiające polecenie Update-Help. Polecenie używa parametru Credential do uruchamiania Update-Help przy użyciu poświadczeń członka grupy Administratorzy na komputerze. Wartość parametru wyzwalacza jest poleceniem , które tworzy wyzwalacz zadania uruchamiający zadanie codziennie o godzinie 3:00.

Aby uruchomić polecenie Register-ScheduledJob, uruchom program PowerShell przy użyciu opcji Uruchom jako administrator. Program PowerShell monituje o podanie hasła użytkownika określonego w parametrze poświadczeń . Poświadczenia są przechowywane z zaplanowanym zadaniem. Po uruchomieniu zadania nie jest wyświetlany monit.

Możesz użyć polecenia cmdlet Get-ScheduledJob, aby wyświetlić zaplanowane zadanie, użyć polecenia cmdlet Set-ScheduledJob, aby go zmienić, i użyć polecenia cmdlet Unregister-ScheduledJob, aby go usunąć. Możesz również wyświetlać zaplanowane zadanie i zarządzać nim w harmonogramie zadań w następującej ścieżce:

Task Scheduler Library\Microsoft\Windows\PowerShell\ScheduledJobs.

Przykład 5. Aktualizowanie plików pomocy na wielu komputerach z udziału plików

W tym przykładzie zaktualizowane pliki pomocy są pobierane z Internetu i zapisywane w udziale plików. Wymagane są poświadczenia użytkownika, które mają uprawnienia dostępu do udziału plików i instalowania aktualizacji. Gdy jest używany udział plików, można zaktualizować komputery, które znajdują się za zaporami lub nie są połączone z Internetem.

PS> Save-Help -DestinationPath \\Server01\Share\PSHelp -Credential Domain01\Admin01
PS> Invoke-Command -ComputerName (Get-Content Servers.txt) -ScriptBlock {
     Update-Help -SourcePath \\Server01\Share\PSHelp -Credential Domain01\Admin01
}

Polecenie Save-Help pobiera najnowsze pliki pomocy dla wszystkich modułów obsługujących aktualizowalną pomoc. Parametr DestinationPath zapisuje pliki w udziale plików \\Server01\Share\PSHelp. Parametr Credential określa użytkownika, który ma uprawnienia dostępu do udziału plików.

Polecenie cmdlet Invoke-Command uruchamia zdalne polecenia Update-Help na wielu komputerach. Parametr ComputerName pobiera listę komputerów zdalnych z pliku Servers.txt. Parametr ScriptBlock uruchamia polecenie Update-Help i używa parametru SourcePath w celu określenia udziału plików zawierającego zaktualizowane pliki pomocy. Parametr Credential określa użytkownika, który może uzyskać dostęp do udziału plików i uruchomić zdalne polecenie Update-Help.

Przykład 6. Pobieranie listy zaktualizowanych plików pomocy

Polecenie cmdlet Update-Help aktualizuje pomoc dotyczącą określonego modułu. Polecenie cmdlet używa Verbose wspólnego parametru, aby wyświetlić listę zaktualizowanych plików pomocy. Możesz użyć pełnej, aby wyświetlić dane wyjściowe dla wszystkich plików pomocy lub plików pomocy dla określonego modułu.

Bez parametru VerboseUpdate-Help nie wyświetla wyników polecenia. Dane wyjściowe parametru pełnej są przydatne do sprawdzania, czy pliki pomocy zostały zaktualizowane lub czy zainstalowano najnowszą wersję.

Update-Help -Module Microsoft.PowerShell.Utility -Verbose

Przykład 7. Znajdowanie modułów obsługujących pomoc z możliwością aktualizowania

W tym przykładzie wymieniono moduły obsługujące pomoc z możliwością aktualizacji. Polecenie używa właściwości HelpInfoUri modułu do identyfikowania modułów obsługujących aktualizowalną pomoc. Właściwość HelpInfoUri zawiera adres przekierowywany po uruchomieniu polecenia cmdlet Update-Help.

Get-Module -ListAvailable | Where-Object -Property HelpInfoUri

Directory: C:\program files\powershell\6\Modules

ModuleType Version    Name                                PSEdition ExportedCommands
---------- -------    ----                                --------- ----------------
Manifest   6.1.0.0    CimCmdlets                          Core      {Get-CimAssociatedInstance... }
Manifest   1.2.2.0    Microsoft.PowerShell.Archive        Desk      {Compress-Archive... }
Manifest   6.1.0.0    Microsoft.PowerShell.Diagnostics    Core      {Get-WinEvent, New-WinEvent}

    Directory: C:\WINDOWS\system32\WindowsPowerShell\v1.0\Modules

ModuleType Version    Name                                PSEdition ExportedCommands
---------- -------    ----                                --------- ----------------
Manifest   2.0.1.0    Appx                                Core,Desk {Add-AppxPackage, ... }
Script     1.0.0.0    AssignedAccess                      Core,Desk {Clear-AssignedAccess, ... }
Manifest   1.0.0.0    BitLocker                           Core,Desk {Unlock-BitLocker, ... }

Przykład 8. Spis zaktualizowanych plików pomocy

W tym przykładzie skrypt Get-UpdateHelpVersion.ps1 tworzy spis plików Pomocy z możliwością aktualizacji dla każdego modułu i ich numerów wersji.

Skrypt identyfikuje moduły obsługujące pomoc aktualizowalną przy użyciu właściwości HelpInfoUri modułów. W przypadku modułów obsługujących pomoc aktualizowalną skrypt wyszukuje i analizuje plik informacji pomocy (*helpinfo.xml), aby znaleźć najnowszy numer wersji.

Skrypt używa klasy PSCustomObject i tabeli skrótów w celu utworzenia niestandardowego obiektu wyjściowego.

# Get-UpdateHelpVersion.ps1
Param(
    [parameter(Mandatory=$False)]
    [String[]]
    $Module
)
$HelpInfoNamespace = @{helpInfo='https://schemas.microsoft.com/powershell/help/2010/05'}

if ($Module) { $Modules = Get-Module $Module -ListAvailable | where {$_.HelpInfoUri} }
else { $Modules = Get-Module -ListAvailable | where {$_.HelpInfoUri} }

foreach ($mModule in $Modules)
{
    $mDir = $mModule.ModuleBase

    if (Test-Path $mdir\*helpinfo.xml)
    {
        $mName=$mModule.Name
        $mNodes = dir $mdir\*helpinfo.xml -ErrorAction SilentlyContinue |
            Select-Xml -Namespace $HelpInfoNamespace -XPath "//helpInfo:UICulture"
        foreach ($mNode in $mNodes)
        {
            $mCulture=$mNode.Node.UICultureName
            $mVer=$mNode.Node.UICultureVersion

            [PSCustomObject]@{"ModuleName"=$mName; "Culture"=$mCulture; "Version"=$mVer}
        }
    }
}

ModuleName                              Culture                                 Version
----------                              -------                                 -------
ActiveDirectory                         en-US                                   3.0.0.0
ADCSAdministration                      en-US                                   3.0.0.0
ADCSDeployment                          en-US                                   3.0.0.0
ADDSDeployment                          en-US                                   3.0.0.0
ADFS                                    en-US                                   3.0.0.0

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

-Credential

Określa poświadczenia użytkownika, który ma uprawnienia dostępu do lokalizacji systemu plików określonej przez SourcePath. Ten parametr jest prawidłowy tylko wtedy, gdy parametr SourcePath lub LiteralPath jest używany w poleceniu .

Parametr Credential umożliwia uruchamianie poleceń za pomocą parametru SourcePath 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ń.

Typ:	PSCredential
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	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 Update-Help jest uruchamiany tylko raz w każdym 24-godzinnym okresie. Pliki do pobrania są ograniczone do 1 GB nieskompresowanej zawartości na moduł, a pliki pomocy są instalowane tylko wtedy, gdy są nowsze niż istniejące pliki na komputerze.

Limit raz dziennie chroni serwery hostujące pliki pomocy i sprawia, że można dodać Update-Help polecenia do profilu programu PowerShell bez ponoszenia kosztów zasobów powtarzających się połączeń lub pobierania.

Aby zaktualizować pomoc dotyczącą modułu w wielu kulturach interfejsu użytkownika bez parametru Force, dołącz wszystkie kultury interfejsu użytkownika w tym samym poleceniu, takie jak:

Update-Help -Module PSScheduledJobs -UICulture en-US, fr-FR, pt-BR

Typ:	SwitchParameter
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-FullyQualifiedModule

Określa moduły o nazwach określonych w postaci obiektów ModuleSpecification. Te moduły opisano w sekcji Uwagi ModuleSpecification Constructor (Hashtable).

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 FullyQualifiedModule w tym samym poleceniu co parametr Module.

Typ:	ModuleSpecification[]
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	True
Akceptowanie symboli wieloznacznych:	False

-LiteralPath

Określa folder dla zaktualizowanych plików pomocy zamiast pobierać je z Internetu. Użyj tego parametru lub SourcePath, jeśli użyto polecenia cmdlet Save-Help w celu pobrania plików pomocy do katalogu.

Możesz potokować obiekt katalogu, taki jak z poleceń cmdlet Get-Item lub Get-ChildItem, do Update-Help.

W przeciwieństwie do wartości SourcePathwartość LiteralPath jest używana dokładnie tak, jak jest typowana. Znaki nie są interpretowane jako symbole wieloznaczne. Jeśli ścieżka zawiera znaki ucieczki, należy ująć ją w pojedynczy cudzysłów. Pojedyncze znaki cudzysłowu informują program PowerShell, aby nie interpretował żadnych znaków jako sekwencji ucieczki.

Typ:	String[]
Aliasy:	PSPath
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	True
Akceptowanie symboli wieloznacznych:	False

-Module

Pomoc dotycząca aktualizacji dla określonych modułów. Wprowadź co najmniej jedną nazwę modułu lub wzorce nazw na liście rozdzielanej przecinkami lub określ plik zawierający jedną nazwę modułu w każdym wierszu. Dozwolone są symbole wieloznaczne. Moduły można potokować za pomocą polecenia cmdlet Get-Module do polecenia cmdlet Update-Help.

Określone moduły muszą być zainstalowane na komputerze, ale nie muszą być importowane do bieżącej sesji. Można określić dowolny moduł w sesji lub dowolny moduł zainstalowany w lokalizacji wymienionej w zmiennej środowiskowej $env:PSModulePath.

Wartość * (wszystkie) próbuje zaktualizować pomoc dla wszystkich modułów zainstalowanych na komputerze. Uwzględnione są 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. Zamiast tego uruchom Update-Help bez parametrów.

Parametr Module polecenia cmdlet Update-Help nie akceptuje pełnej ścieżki pliku modułu ani pliku manifestu modułu. Aby zaktualizować pomoc dotyczącą modułu, który nie znajduje się w lokalizacji $env:PSModulePath, zaimportuj moduł do bieżącej sesji przed uruchomieniem polecenia Update-Help.

Typ:	String[]
Aliasy:	Name
Position:	0
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	True
Akceptowanie symboli wieloznacznych:	True

-Recurse

Wykonuje cykliczne wyszukiwanie plików pomocy w określonym katalogu. Ten parametr jest prawidłowy tylko wtedy, gdy polecenie używa parametru SourcePath.

Typ:	SwitchParameter
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-SourcePath

Określa folder systemu plików, w którym Update-Help pobiera zaktualizowane pliki pomocy, zamiast pobierać je z Internetu. Wprowadź ścieżkę folderu. Nie należy określać nazwy pliku ani rozszerzenia nazwy pliku. Możesz potokować folder, taki jak jeden z poleceń cmdlet Get-Item lub Get-ChildItem, do Update-Help.

Domyślnie Update-Help pobiera zaktualizowane pliki pomocy z Internetu. Użyj SourcePath, gdy użyto polecenia cmdlet Save-Help, aby pobrać zaktualizowane pliki pomocy do katalogu.

Aby określić wartość domyślną SourcePath, przejdź do zasad grupy, Konfiguracja komputerai Ustaw domyślną ścieżkę źródłowąUpdate-Help. To ustawienie zasad grupy uniemożliwia użytkownikom używanie Update-Help do pobierania plików pomocy z Internetu. Aby uzyskać więcej informacji, zobacz about_Group_Policy_Settings.

Typ:	String[]
Position:	1
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-UICulture

Określa wartości kultury interfejsu użytkownika, których Update-Help używa do uzyskiwania zaktualizowanych plików 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 i nie można przesłać częściowego kodu języka, takiego jak de.

Domyślnie Update-Help pobiera pliki pomocy w kulturze interfejsu użytkownika ustawionej dla systemu operacyjnego. Jeśli określisz parametr UICulture, szuka pomocy tylko dla określonej kultury interfejsu użytkownika.

Polecenia korzystające z parametru UICulture kończą się powodzeniem tylko wtedy, gdy moduł udostępnia pliki pomocy dla określonej kultury interfejsu użytkownika. Jeśli polecenie nie powiedzie się, ponieważ określona kultura interfejsu użytkownika nie jest obsługiwana, zostanie wyświetlony komunikat o błędzie.

Typ:	CultureInfo[]
Position:	2
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-UseDefaultCredentials

Wskazuje, że Update-Help uruchamia polecenie, w tym pobieranie z Internetu, przy użyciu poświadczeń bieżącego użytkownika. Domyślnie polecenie jest uruchamiane bez jawnych poświadczeń.

Ten parametr jest skuteczny tylko wtedy, gdy pobieranie internetowe używa nt LAN Manager (NTLM), negocjowania lub uwierzytelniania opartego na protokole Kerberos.

Typ:	SwitchParameter
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
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

DirectoryInfo

Możesz przekazać ścieżkę katalogu do Update-Help.

PSModuleInfo

Obiekt modułu można przekazać potokiem z polecenia cmdlet Get-Module do Update-Help.

Dane wyjściowe

None

Update-Help nie generuje żadnych danych wyjściowych.

Uwagi

Aby zaktualizować pomoc dotyczącą modułów programu PowerShell Core, które zawierają polecenia zainstalowane za pomocą programu PowerShell lub dowolny moduł w katalogu $PSHOME\Modules, uruchom program PowerShell z opcją Uruchom jako administrator.

Tylko członkowie grupy Administratorzy na komputerze mogą aktualizować pomoc dla modułów programu PowerShell Core, poleceń zainstalowanych razem z programem PowerShell oraz modułów w folderze $PSHOME\Modules. Jeśli nie masz uprawnień do aktualizowania plików pomocy, możesz przeczytać pliki pomocy w trybie online. Na przykład Get-Help Update-Help -Online.

Moduły są najmniejszą jednostką aktualizowalnej pomocy. Nie można zaktualizować pomocy dla określonego polecenia cmdlet. Aby znaleźć moduł zawierający określone polecenie cmdlet, użyj właściwości ModuleName polecenia cmdlet Get-Command, na przykład (Get-Command Update-Help).ModuleName.

Ponieważ pliki pomocy są instalowane w katalogu modułów, polecenie cmdlet Update-Help może zainstalować zaktualizowany plik pomocy tylko dla modułów zainstalowanych na komputerze. Jednak polecenie cmdlet Save-Help może zapisać pomoc dotyczącą modułów, które nie są zainstalowane na komputerze.

Jeśli Update-Help nie można odnaleźć zaktualizowanych plików pomocy dla modułu lub nie można odnaleźć zaktualizowanej pomocy w określonym języku, będzie ona kontynuowana w trybie dyskretnym bez wyświetlania komunikatu o błędzie. Aby wyświetlić szczegóły stanu i postępu, użyj parametru Verbose.

Polecenie cmdlet Update-Help zostało wprowadzone w programie Windows PowerShell 3.0. Nie działa we wcześniejszych wersjach programu Windows PowerShell. Na komputerach z programem Windows PowerShell 2.0 i Windows PowerShell 3.0 użyj polecenia cmdlet Update-Help w sesji programu Windows PowerShell 3.0, aby pobrać i zaktualizować pliki pomocy. Pliki pomocy są dostępne zarówno dla programu Windows PowerShell 2.0, jak i programu Windows PowerShell 3.0.

Polecenia cmdlet Update-Help i Save-Help używają następujących portów do pobierania plików pomocy: Port 80 dla protokołu HTTP i port 443 dla protokołu HTTPS.

Update-Help obsługuje wszystkie moduły i przystawki PowerShell Core. Nie obsługuje żadnych innych przystawek.

Aby zaktualizować pomoc dotyczącą modułu w lokalizacji, która nie jest wymieniona w zmiennej środowiskowej $env:PSModulePath, zaimportuj moduł do bieżącej sesji, a następnie uruchom polecenie Update-Help. Uruchom bez parametrów lub użyj parametru modułu , aby określić nazwę modułu. Parametr modułu polecenia cmdlet i nie akceptuje pełnej ścieżki pliku modułu ani pliku manifestu modułu.

Każdy moduł może obsługiwać pomoc z możliwością aktualizacji. Aby uzyskać instrukcje dotyczące obsługi dodatku Updatable Help w modułach, które tworzysz, zobacz Obsługa aktualizowalnej pomocy.

Polecenia cmdlet Update-Help i Save-Help nie są obsługiwane w środowisku preinstalacji systemu Windows (Windows PE).

Udostępnij za pośrednictwem

Update-Help

Składnia

Opis

Przykłady

Przykład 1. Aktualizowanie plików pomocy dla wszystkich modułów

Przykład 2. Aktualizowanie plików pomocy dla określonych modułów

Przykład 3. Aktualizowanie plików pomocy dla różnych języków

Przykład 4. Automatyczne aktualizowanie plików pomocy

Przykład 5. Aktualizowanie plików pomocy na wielu komputerach z udziału plików

Przykład 6. Pobieranie listy zaktualizowanych plików pomocy

Przykład 7. Znajdowanie modułów obsługujących pomoc z możliwością aktualizowania

Przykład 8. Spis zaktualizowanych plików pomocy

Parametry

-Confirm

-Credential

-Force

-FullyQualifiedModule

-LiteralPath

-Module

-Recurse

-SourcePath

-UICulture

-UseDefaultCredentials

-WhatIf

Dane wejściowe

Dane wyjściowe

Uwagi

Dodatkowe zasoby

Udostępnij za pośrednictwem

Update-Help

Składnia

Opis

Przykłady

Przykład 1. Aktualizowanie plików pomocy dla wszystkich modułów

Przykład 2. Aktualizowanie plików pomocy dla określonych modułów

Przykład 3. Aktualizowanie plików pomocy dla różnych języków

Przykład 4. Automatyczne aktualizowanie plików pomocy

Przykład 5. Aktualizowanie plików pomocy na wielu komputerach z udziału plików

Przykład 6. Pobieranie listy zaktualizowanych plików pomocy

Przykład 7. Znajdowanie modułów obsługujących pomoc z możliwością aktualizowania

Przykład 8. Spis zaktualizowanych plików pomocy

Parametry

-Confirm

-Credential

-Force

-FullyQualifiedModule

-LiteralPath

-Module

-Recurse

-SourcePath

-UICulture

-UseDefaultCredentials

-WhatIf

Dane wejściowe

Dane wyjściowe

Uwagi

Linki powiązane

Dodatkowe zasoby