Update-Help

Referenz

Modul:: Microsoft.PowerShell.Core

Lädt die neuesten Hilfedateien auf Ihrem Computer herunter und installiert sie.

Syntax

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

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

Beschreibung

Das cmdlet Update-Help lädt die neuesten Hilfedateien für PowerShell-Module herunter und installiert sie auf Ihrem Computer. Sie müssen PowerShell nicht neu starten, um die Änderung wirksam zu machen. Sie können das Cmdlet Get-Help verwenden, um die neuen Hilfedateien sofort anzuzeigen.

Update-Help überprüft die Version der Hilfedateien auf Ihrem Computer. Wenn Sie keine Hilfedateien für ein Modul haben oder ihre Hilfedateien veraltet sind, lädt Update-Help die neuesten Hilfedateien herunter. Die Hilfedateien können aus dem Internet oder einer Dateifreigabe heruntergeladen und installiert werden.

Ohne Parameter aktualisiert Update-Help die Hilfedateien für Module, die aktualisierbare Hilfe unterstützen und in der Sitzung geladen oder an einem Speicherort installiert werden, der in der $env:PSModulePathenthalten ist. Weitere Informationen finden Sie unter about_Updatable_Help.

Update-Help überprüft die Version der installierten Hilfe. Wenn Update-Help aktualisierte Hilfedateien für ein Modul nicht finden können, wird sie im Hintergrund fortgesetzt, ohne eine Fehlermeldung anzuzeigen. Verwenden Sie den Parameter Force, um die Versionsüberprüfung zu überspringen. Verwenden Sie den parameter Verbose, um Status- und Statusdetails anzuzeigen. Verwenden Sie den parameter Module, um Hilfedateien für ein bestimmtes Modul zu aktualisieren.

Sie können auch Update-Help auf Computern verwenden, die nicht mit dem Internet verbunden sind. Verwenden Sie zunächst das Cmdlet Save-Help, um Hilfedateien aus dem Internet herunterzuladen und in einem freigegebenen Ordner zu speichern, auf den das System zugreifen kann, das nicht mit dem Internet verbunden ist. Verwenden Sie dann den SourcePath Parameter von Update-Help, um die aktualisierten Hilfedateien aus der freigegebenen Datei herunterzuladen und auf dem Computer zu installieren.

Das cmdlet Update-Help wurde in Windows PowerShell 3.0 eingeführt.

Wichtig

Update-Help erfordert Administratorrechte in PowerShell 6.0 und darunter. PowerShell 6.1 und höher legen den Standard-Bereich auf CurrentUserfest. Vor PowerShell 6.1 war der parameter "Scope" nicht verfügbar.

Sie müssen Mitglied der Gruppe "Administratoren" auf dem Computer sein, um die Hilfedateien für die wichtigsten PowerShell-Module zu aktualisieren.

Um die Hilfedateien für Module im PowerShell-Installationsverzeichnis ($PSHOME\Modules) einschließlich der PowerShell Core-Module herunterzuladen oder zu aktualisieren, starten Sie PowerShell mit der Option Als Administrator ausführen. Beispiel: Start-Process pwsh.exe -Verb RunAs.

Beispiele

Beispiel 1: Aktualisieren von Hilfedateien für alle Module

Die Update-Help Cmdlet aktualisiert Hilfedateien für installierte Module, die die aktualisierbare Hilfe unterstützen. Die Benutzeroberflächenkultursprache wird im Betriebssystem festgelegt.

Update-Help

Beispiel 2: Aktualisieren von Hilfedateien für angegebene Module

Das cmdlet Update-Help aktualisiert Hilfedateien nur für Modulnamen, die mit Microsoft.PowerShell-beginnen.

Update-Help -Module Microsoft.PowerShell*

Beispiel 3: Aktualisieren der Hilfe für ein System, das nicht auf das Gebietsschema en-US festgelegt ist

Das Cmdlet Update-Help dient zum Herunterladen von Hilfe in mehreren Sprachen. Wenn jedoch keine Hilfe für die von Ihrem System verwendete Sprache verfügbar ist, wird eine Fehlermeldung für die Modul- und UI-Kultur angezeigt.

In diesem Beispiel wird Update-Help auf einem System ausgeführt, das auf das gebietsschema en-GB festgelegt ist.

Update-Help Microsoft.PowerShell.Utility -Force

Update-Help: Failed to update Help for the module(s) 'Microsoft.PowerShell.Utility' with
UI culture(s) {en-GB} : The specified culture is not supported: en-GB. Specify a culture
from the following list: {en-US}..
English-US help content is available and can be installed using: Update-Help -UICulture en-US.

Die Hilfedateien werden immer für das gebietsschema en-US veröffentlicht. Um die englische Hilfe herunterzuladen, führen Sie Update-Help mit dem Parameter UICulture aus, und geben Sie das gebietsschema en-US an.

Beispiel 4: Aktualisieren von Hilfedateien auf mehreren Computern aus einer Dateifreigabe

In diesem Beispiel werden aktualisierte Hilfedateien aus dem Internet heruntergeladen und in einer Dateifreigabe gespeichert. Benutzeranmeldeinformationen sind erforderlich, die über Berechtigungen für den Zugriff auf die Dateifreigabe und die Installation von Updates verfügen. Wenn eine Dateifreigabe verwendet wird, ist es möglich, Computer zu aktualisieren, die sich hinter Firewalls befinden oder nicht mit dem Internet verbunden sind.

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

Der Befehl Save-Help lädt die neuesten Hilfedateien für alle Module herunter, die aktualisierbare Hilfe unterstützen. Der parameter DestinationPath speichert die Dateien in der \\Server01\Share\PSHelp Dateifreigabe. Der Parameter Credential gibt einen Benutzer an, der über die Berechtigung für den Zugriff auf die Dateifreigabe verfügt.

Das Cmdlet Invoke-Command führt Remote-Update-Help Befehle auf mehreren Computern aus. Der parameter ComputerName ruft eine Liste von Remotecomputern aus der datei Servers.txt ab. Der parameter ScriptBlock führt den befehl Update-Help aus und verwendet den parameter SourcePath, um die Dateifreigabe anzugeben, die die aktualisierten Hilfedateien enthält. Der Parameter Credential gibt einen Benutzer an, der auf die Dateifreigabe zugreifen und den Remotebefehl Update-Help ausführen kann.

Beispiel 5: Abrufen einer Liste der aktualisierten Hilfedateien

Die Update-Help Cmdlet aktualisiert Hilfe für ein angegebenes Modul. Das Cmdlet verwendet den Verbose allgemeinen Parameter, um die Liste der aktualisierten Hilfedateien anzuzeigen. Sie können ausführliche verwenden, um die Ausgabe für alle Hilfedateien oder Hilfedateien für ein bestimmtes Modul anzuzeigen.

Ohne den parameter Verbose zeigt Update-Help die Ergebnisse des Befehls nicht an. Die Ausführliche Parameterausgabe ist hilfreich, um zu überprüfen, ob die Hilfedateien aktualisiert wurden oder ob die neueste Version installiert ist.

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

Beispiel 6: Suchen von Modulen, die die aktualisierbare Hilfe unterstützen

In diesem Beispiel werden Module aufgelistet, die die aktualisierbare Hilfe unterstützen. Der Befehl verwendet die HelpInfoUri--Eigenschaft des Moduls, um Module zu identifizieren, die die aktualisierbare Hilfe unterstützen. Die HelpInfoUri--Eigenschaft enthält eine URL, die beim Ausführen des cmdlets Update-Help umgeleitet wird.

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, ... }

Beispiel 7: Inventur aktualisierte Hilfedateien

In diesem Beispiel erstellt das Skript Get-UpdateHelpVersion.ps1 eine Bestandsaufnahme der aktualisierbaren Hilfedateien für jedes Modul und deren Versionsnummern.

Das Skript identifiziert Module, die die aktualisierbare Hilfe mithilfe der HelpInfoUri Eigenschaft von Modulen unterstützen. Für Module, die die aktualisierbare Hilfe unterstützen, sucht und analysiert das Skript die Hilfeinformationsdatei (*helpinfo.xml), um die neueste Versionsnummer zu finden.

Das Skript verwendet die PSCustomObject Klasse und eine Hashtabelle, um ein benutzerdefiniertes Ausgabeobjekt zu erstellen.

# Get-UpdateHelpVersion.ps1
Param(
    [parameter(Mandatory=$False)]
    [String[]]
    $Module
)
$HelpInfoNamespace = @{helpInfo='http://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

Parameter

-Confirm

Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.

Typ:	SwitchParameter
Aliase:	cf
Position:	Named
Standardwert:	False
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Credential

Gibt Anmeldeinformationen eines Benutzers an, der über die Berechtigung für den Zugriff auf den durch SourcePath-angegebenen Dateisystemspeicherort verfügt. Dieser Parameter ist nur gültig, wenn der SourcePath oder LiteralPath Parameter im Befehl verwendet wird.

Mit dem parameter Credential können Sie Update-Help Befehle mit dem parameter SourcePath auf Remotecomputern ausführen. Indem Sie explizite Anmeldeinformationen angeben, können Sie den Befehl auf einem Remotecomputer ausführen und auf eine Dateifreigabe auf einem dritten Computer zugreifen, ohne dass ein Zugriff verweigert wird oder die CredSSP-Authentifizierung zum Delegieren von Anmeldeinformationen verwendet wird.

Geben Sie einen Benutzernamen ein, z. B. User01 oder Domain01\User01, oder geben Sie ein PSCredential-Objekt ein, das vom cmdlet Get-Credential generiert wird. Wenn Sie einen Benutzernamen eingeben, werden Sie aufgefordert, das Kennwort einzugeben.

Anmeldeinformationen werden in einem PSCredential-Objekt gespeichert, und das Kennwort wird als SecureString-gespeichert.

Anmerkung

Weitere Informationen zu SecureString Datenschutz finden Sie unter Wie sicher ist SecureString?.

Typ:	PSCredential
Position:	Named
Standardwert:	Current user
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Force

Gibt an, dass dieses Cmdlet nicht der Einschränkung von einmal pro Tag folgt, die Versionsüberprüfung überspringt und Dateien herunterlädt, die den Grenzwert von 1 GB überschreiten.

Ohne diesen Parameter wird Update-Help nur einmal in jedem 24-Stunden-Zeitraum ausgeführt. Downloads sind auf 1 GB nicht komprimierter Inhalte pro Modul beschränkt, und Hilfedateien werden nur installiert, wenn sie neuer sind als die vorhandenen Dateien auf dem Computer.

Der Grenzwert für einmal pro Tag schützt die Server, die die Hilfedateien hosten, und macht es praktisch, dass Sie Ihrem PowerShell-Profil einen Update-Help Befehl hinzufügen können, ohne dass die Ressourcenkosten für wiederholte Verbindungen oder Downloads entstehen.

Um Hilfe für ein Modul in mehreren Benutzeroberflächenkulturen ohne den Parameter "force" zu aktualisieren, schließen Sie alle Benutzeroberflächenkulturen in denselben Befehl ein, z. B.:

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

Typ:	SwitchParameter
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-FullyQualifiedModule

Der Wert kann ein Modulname, eine vollständige Modulspezifikation oder ein Pfad zu einer Moduldatei sein.

Wenn der Wert ein Pfad ist, kann der Pfad vollqualifizierte oder relativ sein. Ein relativer Pfad wird relativ zum Skript aufgelöst, das die using-Anweisung enthält.

Wenn es sich bei dem Wert um einen Namen oder eine Modulspezifikation handelt, durchsucht PowerShell die PSModulePath- nach dem angegebenen Modul.

Eine Modulspezifikation ist eine Hashtabelle mit den folgenden Schlüsseln.

ModuleName - Erforderlicher Gibt den Modulnamen an.
GUID - Optionaler Gibt die GUID des Moduls an.
Außerdem Erforderlicher, um mindestens einen der drei folgenden Tasten anzugeben.
- ModuleVersion – Gibt eine akzeptable Mindestversion des Moduls an.
- MaximumVersion – Gibt die maximal zulässige Version des Moduls an.
- RequiredVersion – Gibt eine genaue, erforderliche Version des Moduls an. Dies kann nicht mit den anderen Versionsschlüsseln verwendet werden.

Sie können den parameter FullyQualifiedModule nicht im selben Befehl wie ein Module-Parameter angeben.

Typ:	ModuleSpecification[]
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	True
Platzhalterzeichen akzeptieren:	False

-LiteralPath

Gibt den Ordner für aktualisierte Hilfedateien an, anstatt sie aus dem Internet herunterzuladen. Verwenden Sie diesen Parameter oder SourcePath-, wenn Sie das cmdlet Save-Help zum Herunterladen von Hilfedateien in ein Verzeichnis verwendet haben.

Sie können ein Verzeichnisobjekt, z. B. aus dem Get-Item oder Get-ChildItem Cmdlets, an Update-Helpweiterleiten.

Im Gegensatz zum Wert von SourcePath-wird der Wert LiteralPath- genau wie eingegeben verwendet. Es werden keine Zeichen als Wildcardzeichen interpretiert. Wenn der Pfad Escapezeichen enthält, schließen Sie ihn in einfache Anführungszeichen ein. Einfache Anführungszeichen weisen PowerShell an, keine Zeichen als Escapesequenzen zu interpretieren.

Typ:	String[]
Aliase:	PSPath, LP
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	True
Platzhalterzeichen akzeptieren:	False

-Module

Aktualisiert hilfe für die angegebenen Module. Geben Sie einen oder mehrere Modulnamen oder Namensmuster in eine durch Trennzeichen getrennte Liste ein, oder geben Sie eine Datei an, in der in jeder Zeile ein Modulname aufgeführt wird. Wildcardzeichen sind zulässig. Sie können Module aus dem Cmdlet Get-Module an das Cmdlet Update-Help weiterleiten.

Die von Ihnen angegebenen Module müssen auf dem Computer installiert sein, müssen jedoch nicht in die aktuelle Sitzung importiert werden. Sie können jedes Modul in der Sitzung oder ein beliebiges Modul angeben, das an einem Speicherort installiert ist, der in der umgebungsvariablen $env:PSModulePath aufgeführt ist.

Der Wert * (alle) versucht, Hilfe für alle Module zu aktualisieren, die auf dem Computer installiert sind. Module, die die aktualisierbare Hilfe nicht unterstützen, sind enthalten. Dieser Wert kann Fehler generieren, wenn der Befehl auf Module trifft, die keine aktualisierbare Hilfe unterstützen. Führen Sie stattdessen Update-Help ohne Parameter aus.

Der parameter Module des Cmdlets Update-Help akzeptiert nicht den vollständigen Pfad einer Moduldatei oder Modulmanifestdatei. Um Hilfe für ein Modul zu aktualisieren, das sich nicht an einem $env:PSModulePath Speicherort befindet, importieren Sie das Modul in die aktuelle Sitzung, bevor Sie den befehl Update-Help ausführen.

Typ:	String[]
Aliase:	Name
Position:	0
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	True
Platzhalterzeichen akzeptieren:	True

-Recurse

Führt eine rekursive Suche nach Hilfedateien im angegebenen Verzeichnis aus. Dieser Parameter ist nur gültig, wenn der Befehl den parameter SourcePath verwendet.

Typ:	SwitchParameter
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Scope

Gibt den Systembereich an, in dem Hilfe aktualisiert wird. Updates im AllUsers Bereich erfordern Administratorrechte auf Windows-Systemen. Der parameter -Scope wurde in PowerShell Core, Version 6.1, eingeführt.

CurrentUser- ist der Standardbereich für Hilfedateien in PowerShell 6.1 und höher. AllUsers- kann angegeben werden, um Hilfe für alle Benutzer zu installieren oder zu aktualisieren. Auf Unix-Systemen sind sudo Berechtigungen erforderlich, um Hilfe für alle Benutzer zu aktualisieren. Beispiel: sudo pwsh -c Update-Help

Die zulässigen Werte sind:

CurrentUser
AllUsers

Typ:	UpdateHelpScope
Position:	Named
Standardwert:	CurrentUser
Erforderlich:	False
Pipelineeingabe akzeptieren:	True
Platzhalterzeichen akzeptieren:	False

-SourcePath

Gibt einen Dateisystemordner an, in dem Update-Help aktualisierte Hilfedateien erhält, anstatt sie aus dem Internet herunterzuladen. Geben Sie den Pfad eines Ordners ein. Geben Sie keine Dateinamen- oder Dateinamenerweiterung an. Sie können einen Ordner, z. B. aus dem Get-Item oder Get-ChildItem Cmdlets, an Update-Helpweiterleiten.

Standardmäßig lädt Update-Help aktualisierte Hilfedateien aus dem Internet herunter. Verwenden Sie SourcePath-, wenn Sie das cmdlet Save-Help zum Herunterladen aktualisierter Hilfedateien in ein Verzeichnis verwendet haben.

Um einen Standardwert für SourcePath-anzugeben, wechseln Sie zu Gruppenrichtlinie, Computerkonfiguration, und Legen Sie den Standardquellpfad für Update-Help-fest. Diese Gruppenrichtlinieneinstellung verhindert, dass Benutzer Update-Help verwenden, um Hilfedateien aus dem Internet herunterzuladen. Weitere Informationen finden Sie unter about_Group_Policy_Settings.

Typ:	String[]
Aliase:	Path
Position:	1
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-UICulture

Gibt Werte für die Benutzeroberflächenkultur an, für die dieses Cmdlet aktualisierte Hilfedateien abruft. Geben Sie einen oder mehrere Sprachcodes ein, z. B. es-ES, eine Variable, die Kulturobjekte enthält, oder einen Befehl, der Kulturobjekte abruft, z. B. ein Get-Culture- oder Get-UICulture-Befehl. Wildcardzeichen sind nicht zulässig.

Standardmäßig ruft Update-Help Hilfedateien in der Ui-Kultur ab, die für das Betriebssystem oder die Fallbackkultur festgelegt ist. Wenn Sie den parameter UICulture angeben, sucht Update-Help nur nach Hilfe für die angegebene Sprache.

Ab PowerShell 7.4 können Sie einen teilweisen Sprachcode verwenden, z. B. en, um Hilfe für jede Region in Englisch herunterzuladen.

Anmerkung

Ubuntu 18.04 hat die Standardgebietsschemaeinstellung in C.UTF.8geändert, was keine erkannte Benutzeroberflächenkultur ist. Update-Help kann hilfe nicht im Hintergrund heruntergeladen werden, es sei denn, Sie verwenden diesen Parameter mit einem unterstützten Gebietsschema wie en-US. Dies kann auf jeder Plattform auftreten, die einen nicht unterstützten Wert verwendet.

Typ:	CultureInfo[]
Position:	2
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-UseDefaultCredentials

Gibt an, dass Update-Help den Befehl ausführt, einschließlich des Internetdownloads, mithilfe der Anmeldeinformationen des aktuellen Benutzers. Standardmäßig wird der Befehl ohne explizite Anmeldeinformationen ausgeführt.

Dieser Parameter ist nur wirksam, wenn der Webdownload NT LAN Manager (NTLM), Aushandeln oder Kerberos-basierte Authentifizierung verwendet.

Typ:	SwitchParameter
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-WhatIf

Zeigt, was passiert, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Typ:	SwitchParameter
Aliase:	wi
Position:	Named
Standardwert:	False
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

Eingaben

DirectoryInfo

Sie können ein Verzeichnispfadobjekt an dieses Cmdlet weiterleiten.

PSModuleInfo

Sie können ein Modulobjekt an dieses Cmdlet weiterleiten.

Ausgaben

None

Dieses Cmdlet gibt keine Ausgabe zurück.

Hinweise

Um Hilfe für die wichtigsten PowerShell-Module zu aktualisieren, die die befehle enthalten, die mit PowerShell oder einem beliebigen Modul im verzeichnis $PSHOME\Modules installiert sind, starten Sie PowerShell mit der Option zum Als Administrator ausführen.

Nur Mitglieder der Gruppe "Administratoren" auf dem Computer können Hilfe für die wichtigsten PowerShell-Module, die Befehle, die zusammen mit PowerShell installiert sind, und für Module im Ordner $PSHOME\Modules aktualisieren. Wenn Sie nicht über die Berechtigung zum Aktualisieren von Hilfedateien verfügen, können Sie die Hilfedateien online lesen. Beispiel: Get-Help Update-Help -Online.

Module sind die kleinste Einheit aktualisierbarer Hilfe. Sie können die Hilfe für ein bestimmtes Cmdlet nicht aktualisieren. Um das Modul zu finden, das ein bestimmtes Cmdlet enthält, verwenden Sie die ModuleName-Eigenschaft des Cmdlets Get-Command, z. B. (Get-Command Update-Help).ModuleName.

Da Hilfedateien im Modulverzeichnis installiert sind, kann das cmdlet Update-Help aktualisierte Hilfedatei nur für Module installieren, die auf dem Computer installiert sind. Das Cmdlet Save-Help kann jedoch Hilfe für Module speichern, die nicht auf dem Computer installiert sind.

Das cmdlet Update-Help wurde in Windows PowerShell 3.0 eingeführt. Es funktioniert nicht in früheren Versionen von PowerShell. Verwenden Sie auf Computern mit Windows PowerShell 2.0 und Windows PowerShell 3.0 das cmdlet Update-Help in einer Windows PowerShell 3.0-Sitzung, um Hilfedateien herunterzuladen und zu aktualisieren. Die Hilfedateien sind sowohl für Windows PowerShell 2.0 als auch für Windows PowerShell 3.0 verfügbar.

Die cmdlets Update-Help und Save-Help verwenden die folgenden Ports zum Herunterladen von Hilfedateien: Port 80 für HTTP und Port 443 für HTTPS.

Update-Help unterstützt alle Module und die wichtigsten PowerShell-Snap-Ins. Es werden keine anderen Snap-Ins unterstützt.

Um Hilfe für ein Modul an einem Speicherort zu aktualisieren, der nicht in der umgebungsvariablen $env:PSModulePath aufgeführt ist, importieren Sie das Modul in die aktuelle Sitzung, und führen Sie dann einen Update-Help Befehl aus. Führen Sie Update-Help ohne Parameter aus, oder verwenden Sie den parameter Module, um den Modulnamen anzugeben. Der Module Parameter der Update-Help und Save-Help Cmdlets akzeptiert nicht den vollständigen Pfad einer Moduldatei oder Modulmanifestdatei.

Jedes Modul kann die aktualisierbare Hilfe unterstützen. Anweisungen zum Unterstützen der aktualisierbaren Hilfe in den modulen, die Sie erstellen, finden Sie unter Unterstützende aktualisierbare Hilfe.

Die Cmdlets Update-Help und Save-Help werden unter Windows Preinstallation Environment (Windows PE) nicht unterstützt.

Freigeben über

Update-Help

Syntax

Beschreibung

Beispiele

Beispiel 1: Aktualisieren von Hilfedateien für alle Module

Beispiel 2: Aktualisieren von Hilfedateien für angegebene Module

Beispiel 3: Aktualisieren der Hilfe für ein System, das nicht auf das Gebietsschema en-US festgelegt ist

Beispiel 4: Aktualisieren von Hilfedateien auf mehreren Computern aus einer Dateifreigabe

Beispiel 5: Abrufen einer Liste der aktualisierten Hilfedateien

Beispiel 6: Suchen von Modulen, die die aktualisierbare Hilfe unterstützen

Beispiel 7: Inventur aktualisierte Hilfedateien

Parameter

-Confirm

-Credential

-Force

-FullyQualifiedModule

-LiteralPath

-Module

-Recurse

-Scope

-SourcePath

-UICulture

-UseDefaultCredentials

-WhatIf

Eingaben

Ausgaben

Hinweise

Zusätzliche Ressourcen

Freigeben über

Update-Help

Syntax

Beschreibung

Beispiele

Beispiel 1: Aktualisieren von Hilfedateien für alle Module

Beispiel 2: Aktualisieren von Hilfedateien für angegebene Module

Beispiel 3: Aktualisieren der Hilfe für ein System, das nicht auf das Gebietsschema en-US festgelegt ist

Beispiel 4: Aktualisieren von Hilfedateien auf mehreren Computern aus einer Dateifreigabe

Beispiel 5: Abrufen einer Liste der aktualisierten Hilfedateien

Beispiel 6: Suchen von Modulen, die die aktualisierbare Hilfe unterstützen

Beispiel 7: Inventur aktualisierte Hilfedateien

Parameter

-Confirm

-Credential

-Force

-FullyQualifiedModule

-LiteralPath

-Module

-Recurse

-Scope

-SourcePath

-UICulture

-UseDefaultCredentials

-WhatIf

Eingaben

Ausgaben

Hinweise

Ähnliche Themen

Zusätzliche Ressourcen