Dela via


Update-Help

Laddar ned och installerar de senaste hjälpfilerna på datorn.

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>]

Description

Cmdleten Update-Help laddar ned de senaste hjälpfilerna för PowerShell-moduler och installerar dem på datorn. Du behöver inte starta om PowerShell för att ändringen ska gälla. Du kan använda cmdleten Get-Help för att visa de nya hjälpfilerna omedelbart.

Update-Help kontrollerar versionen av hjälpfilerna på datorn. Om du inte har hjälpfiler för en modul eller om dina hjälpfiler är inaktuella Update-Help hämtar de senaste hjälpfilerna. Hjälpfilerna kan laddas ned och installeras från Internet eller en filresurs.

Utan parametrar uppdaterar Update-Help hjälpfilerna för moduler som stöder uppdateringsbar hjälp och läses in i sessionen eller installeras på en plats som ingår i $env:PSModulePath. Mer information finns i about_Updatable_Help.

Update-Help kontrollerar vilken version av hjälpen som är installerad. Om Update-Help inte kan hitta uppdaterade hjälpfiler för en modul fortsätter den tyst utan att ett felmeddelande visas. Använd parametern Force för att hoppa över versionskontrollen. Använd parametern Utförlig för att se status- och förloppsinformation. Använd parametern Module för att uppdatera hjälpfiler för en viss modul.

Du kan också använda Update-Help på datorer som inte är anslutna till Internet. Använd först cmdleten Save-Helpför att ladda ned hjälpfiler från Internet och spara dem i en delad mapp som är tillgänglig för systemet som inte är ansluten till Internet. Använd sedan parametern SourcePath för Update-Help för att ladda ned de uppdaterade hjälpfilerna från den delade och installera dem på datorn.

Cmdleten Update-Help introducerades i Windows PowerShell 3.0.

Viktig

Update-Help kräver administratörsbehörighet i PowerShell 6.0 och nedan. PowerShell 6.1 och senare anger standardvärdet Omfång till CurrentUser. Före PowerShell 6.1 var parametern Scope inte tillgänglig.

Du måste vara medlem i gruppen Administratörer på datorn för att uppdatera hjälpfilerna för kärnmodulerna i PowerShell.

Om du vill ladda ned eller uppdatera hjälpfilerna för moduler i PowerShell-installationskatalogen ($PSHOME\Modules), inklusive PowerShell Core-modulerna, startar du PowerShell med alternativet Kör som administratör. Till exempel: Start-Process pwsh.exe -Verb RunAs.

Exempel

Exempel 1: Uppdatera hjälpfiler för alla moduler

Cmdleten Update-Help uppdaterar hjälpfilerna för installerade moduler som stöder uppdateringsbar hjälp. Kulturspråket för användargränssnittet (UI) anges i operativsystemet.

Update-Help

Exempel 2: Uppdatera hjälpfiler för angivna moduler

Cmdleten Update-Help uppdaterar endast hjälpfiler för modulnamn som börjar med Microsoft.PowerShell.

Update-Help -Module Microsoft.PowerShell*

Exempel 3: Uppdatera hjälpen i ett system som inte är inställt på en-US nationella inställningar

Cmdleten Update-Help är utformad för att ladda ned hjälp på flera språk. Men när det inte finns någon tillgänglig hjälp för det språk som systemet använder visas ett felmeddelande för modulen och användargränssnittskulturen.

I det här exemplet körs Update-Help på ett system som är inställt på en-GB nationella inställningar.

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.

Hjälpfilerna publiceras alltid för en-US nationella inställningar. Om du vill ladda ned den engelska hjälpen kör du Update-Help med parametern UICulture och anger en-US nationella inställningar.

Exempel 4: Uppdatera hjälpfiler på flera datorer från en filresurs

I det här exemplet laddas uppdaterade hjälpfiler ned från Internet och sparas i en filresurs. Användarautentiseringsuppgifter krävs som har behörighet att komma åt filresursen och installera uppdateringar. När en filresurs används är det möjligt att uppdatera datorer som finns bakom brandväggar eller som inte är anslutna till Internet.

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
}

Kommandot Save-Help hämtar de senaste hjälpfilerna för alla moduler som stöder uppdateringsbar hjälp. Parametern DestinationPath sparar filerna i \\Server01\Share\PSHelp filresursen. Parametern Credential anger en användare som har behörighet att komma åt filresursen.

Cmdleten Invoke-Command kör fjärrkommandon Update-Help på flera datorer. Parametern ComputerName hämtar en lista över fjärrdatorer från Servers.txt-filen. Parametern ScriptBlock kör kommandot Update-Help och använder parametern SourcePath för att ange filresursen som innehåller de uppdaterade hjälpfilerna. Parametern Credential anger en användare som kan komma åt filresursen och köra fjärrkommandot Update-Help.

Exempel 5: Hämta en lista över uppdaterade hjälpfiler

Cmdleten Update-Help uppdaterar hjälpen för en angiven modul. Cmdleten använder den utförliga gemensamma parametern för att visa listan över hjälpfiler som har uppdaterats. Du kan använda utförliga för att visa utdata för alla hjälpfiler eller hjälpfiler för en specifik modul.

Utan parametern Utförlig visar Update-Help inte kommandots resultat. Den utförliga parameterutdata är användbar för att kontrollera att hjälpfilerna har uppdaterats eller om den senaste versionen är installerad.

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

Exempel 6: Hitta moduler som stöder uppdateringsbar hjälp

I det här exemplet visas moduler som stöder uppdateringsbar hjälp. Kommandot använder modulens egenskap HelpInfoUri för att identifiera moduler som stöder uppdateringsbar hjälp. Egenskapen HelpInfoUri innehåller en URL som omdirigeras när Update-Help-cmdleten körs.

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

Exempel 7: Inventering uppdaterade hjälpfiler

I det här exemplet skapar skriptet Get-UpdateHelpVersion.ps1 en inventering av updatable-hjälpfilerna för varje modul och deras versionsnummer.

Skriptet identifierar moduler som stöder uppdateringsbar hjälp med hjälp av egenskapen HelpInfoUri för moduler. För moduler som stöder uppdateringsbar hjälp söker skriptet efter och parsar hjälpinformationsfilen (*helpinfo.xml) för att hitta det senaste versionsnumret.

Skriptet använder PSCustomObject-klass och en hash-tabell för att skapa ett anpassat utdataobjekt.

# 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

Parametrar

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

Typ:SwitchParameter
Alias:cf
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Credential

Anger autentiseringsuppgifter för en användare som har behörighet att komma åt filsystemplatsen som anges av SourcePath. Den här parametern är endast giltig när parametern SourcePath eller LiteralPath används i kommandot.

Med parametern Credential kan du köra Update-Help kommandon med parametern SourcePath på fjärrdatorer. Genom att ange explicita autentiseringsuppgifter kan du köra kommandot på en fjärrdator och komma åt en filresurs på en tredje dator utan att stöta på ett fel om nekad åtkomst eller använda CredSSP-autentisering för att delegera autentiseringsuppgifter.

Ange ett användarnamn, till exempel User01 eller Domain01\User01, eller ange ett PSCredential- objekt som genereras av cmdleten Get-Credential. Om du skriver ett användarnamn uppmanas du att ange lösenordet.

Autentiseringsuppgifter lagras i ett PSCredential--objekt och lösenordet lagras som en SecureString-.

Not

Mer information om SecureString dataskydd finns i Hur säker är SecureString?.

Typ:PSCredential
Position:Named
Standardvärde:Current user
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Force

Anger att den här cmdleten inte följer begränsningen en gång per dag, hoppar över versionskontrollen och laddar ned filer som överskrider gränsen på 1 GB.

Utan den här parametern körs Update-Help bara en gång under varje 24-timmarsperiod. Nedladdningar är begränsade till 1 GB okomprimerat innehåll per modul och hjälpfiler installeras endast när de är nyare än de befintliga filerna på datorn.

Gränsen en gång per dag skyddar de servrar som är värdar för hjälpfilerna och gör det praktiskt att lägga till ett Update-Help kommando i PowerShell-profilen utan att medföra resurskostnaden för upprepade anslutningar eller nedladdningar.

Om du vill uppdatera hjälpen för en modul i flera användargränssnittskulturer utan parametern Force tar du med alla användargränssnittskulturer i samma kommando, till exempel:

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

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-FullyQualifiedModule

Värdet kan vara ett modulnamn, en fullständig modulspecifikation eller en sökväg till en modulfil.

När värdet är en sökväg kan sökvägen vara fullständigt kvalificerad eller relativ. En relativ sökväg matchas i förhållande till skriptet som innehåller instruktionen using.

När värdet är ett namn eller en modulspecifikation söker PowerShell efter den angivna modulen i PSModulePath-.

En modulspecifikation är en hashtable som har följande nycklar.

  • ModuleName - Obligatoriskt Anger modulnamnet.
  • GUID - Valfri Anger GUID för modulen.
  • Det är också Krävs för att ange minst en av de tre nycklarna nedan.
    • ModuleVersion – Anger en lägsta godtagbar version av modulen.
    • MaximumVersion – Anger den maximala godkända versionen av modulen.
    • RequiredVersion – Anger en exakt, nödvändig version av modulen. Detta kan inte användas med de andra versionsnycklarna.

Du kan inte ange parametern FullyQualifiedModule i samma kommando som parametern Module.

Typ:ModuleSpecification[]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-LiteralPath

Anger mappen för uppdaterade hjälpfiler i stället för att ladda ned dem från Internet. Använd den här parametern eller SourcePath- om du har använt cmdleten Save-Help för att ladda ned hjälpfiler till en katalog.

Du kan pipelines ett katalogobjekt, till exempel från Get-Item eller Get-ChildItem cmdletar, till Update-Help.

Till skillnad från värdet för SourcePathanvänds värdet för LiteralPath precis som det skrivs. Inga tecken tolkas som jokertecken. Om sökvägen innehåller escape-tecken omger du den med enkla citattecken. Enkla citattecken gör att PowerShell inte tolkar några tecken som escape-sekvenser.

Typ:String[]
Alias:PSPath, LP
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-Module

Uppdateringshjälp för de angivna modulerna. Ange ett eller flera modulnamn eller namnmönster i en kommaavgränsad lista eller ange en fil som visar ett modulnamn på varje rad. Jokertecken tillåts. Du kan pipelinemoduler från cmdleten Get-Module till cmdleten Update-Help.

De moduler som du anger måste vara installerade på datorn, men de behöver inte importeras till den aktuella sessionen. Du kan ange valfri modul i sessionen eller någon modul som är installerad på en plats som anges i $env:PSModulePath miljövariabeln.

Värdet * (alla) försöker uppdatera hjälpen för alla moduler som är installerade på datorn. Moduler som inte stöder uppdateringsbar hjälp ingår. Det här värdet kan generera fel när kommandot stöter på moduler som inte stöder uppdateringsbar hjälp. Kör i stället Update-Help utan parametrar.

Parametern Module för cmdleten Update-Help accepterar inte den fullständiga sökvägen för en modulfil eller modulmanifestfil. Om du vill uppdatera hjälpen för en modul som inte finns på en $env:PSModulePath plats importerar du modulen till den aktuella sessionen innan du kör kommandot Update-Help.

Typ:String[]
Alias:Name
Position:0
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:True

-Recurse

Utför en rekursiv sökning efter hjälpfiler i den angivna katalogen. Den här parametern är endast giltig när kommandot använder parametern SourcePath.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Scope

Anger systemomfattningen där hjälpen uppdateras. Uppdateringar på AllUsers omfånget kräver administratörsbehörighet på Windows-system. Parametern -Scope introducerades i PowerShell Core version 6.1.

CurrentUser är standardomfånget för hjälpfiler i PowerShell 6.1 och senare. AllUsers kan anges för att installera eller uppdatera hjälp för alla användare. I Unix-system krävs sudo behörigheter för att uppdatera hjälpen för alla användare. Till exempel: sudo pwsh -c Update-Help

De godtagbara värdena är:

  • CurrentUser
  • Allaanvändare
Typ:UpdateHelpScope
Position:Named
Standardvärde:CurrentUser
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-SourcePath

Anger en filsystemmapp där Update-Help hämtar uppdaterade hjälpfiler i stället för att ladda ned dem från Internet. Ange sökvägen till en mapp. Ange inte filnamn eller filnamnstillägg. Du kan pipelines en mapp, till exempel en från Get-Item eller Get-ChildItem cmdlets, till Update-Help.

Som standard hämtar Update-Help uppdaterade hjälpfiler från Internet. Använd SourcePath- när du har använt cmdleten Save-Help för att ladda ned uppdaterade hjälpfiler till en katalog.

Om du vill ange ett standardvärde för SourcePathgår du till grupprincip, Datorkonfigurationoch Ange standardsökvägen för. Den här grupprincipinställningen hindrar användare från att använda Update-Help för att ladda ned hjälpfiler från Internet. Mer information finns i about_Group_Policy_Settings.

Typ:String[]
Alias:Path
Position:1
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-UICulture

Anger UI-kulturvärden som den här cmdleten hämtar uppdaterade hjälpfiler för. Ange en eller flera språkkoder, till exempel es-ES, en variabel som innehåller kulturobjekt eller ett kommando som hämtar kulturobjekt, till exempel ett Get-Culture- eller Get-UICulture kommando. Jokertecken tillåts inte.

Som standard hämtar Update-Help hjälpfiler i UI-kulturuppsättningen för operativsystemet eller dess återställningskultur. Om du anger parametern UICulture söker Update-Help bara efter hjälp för det angivna språket.

Från och med PowerShell 7.4 kan du använda en delvis språkkod, till exempel en för att ladda ned hjälp på engelska för alla regioner.

Not

Ubuntu 18.04 ändrade standardinställningen för nationella inställningar till C.UTF.8, som inte är en erkänd användargränssnittskultur. Update-Help kan inte ladda ned hjälpen i tyst namn om du inte använder den här parametern med ett språk som stöds som en-US. Detta kan inträffa på alla plattformar som använder ett värde som inte stöds.

Typ:CultureInfo[]
Position:2
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-UseDefaultCredentials

Anger att Update-Help kör kommandot, inklusive internetnedladdningen, med den aktuella användarens autentiseringsuppgifter. Som standard körs kommandot utan explicita autentiseringsuppgifter.

Den här parametern gäller endast när webbnedladdningen använder NT LAN Manager (NTLM), förhandlar eller Kerberos-baserad autentisering.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-WhatIf

Visar vad som skulle hända om cmdleten körs. Cmdleten körs inte.

Typ:SwitchParameter
Alias:wi
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

Indata

DirectoryInfo

Du kan skicka ett katalogsökvägsobjekt till den här cmdleten.

PSModuleInfo

Du kan skicka ett modulobjekt till den här cmdleten.

Utdata

None

Den här cmdleten returnerar inga utdata.

Kommentarer

Om du vill uppdatera hjälpen för de grundläggande PowerShell-modulerna, som innehåller kommandona som är installerade med PowerShell eller någon modul i $PSHOME\Modules-katalogen, startar du PowerShell med alternativet att Kör som administratör.

Endast medlemmar i gruppen Administratörer på datorn kan uppdatera hjälpen för de grundläggande PowerShell-modulerna, kommandona som installeras tillsammans med PowerShell och för moduler i mappen $PSHOME\Modules. Om du inte har behörighet att uppdatera hjälpfiler kan du läsa hjälpfilerna online. Till exempel Get-Help Update-Help -Online.

Moduler är den minsta enheten med uppdaterad hjälp. Du kan inte uppdatera hjälpen för en viss cmdlet. Om du vill hitta modulen som innehåller en viss cmdlet använder du egenskapen ModuleName för cmdleten Get-Command, till exempel (Get-Command Update-Help).ModuleName.

Eftersom hjälpfiler installeras i modulkatalogen kan Update-Help-cmdleten endast installera den uppdaterade hjälpfilen för moduler som är installerade på datorn. Men cmdleten Save-Help kan spara hjälp för moduler som inte är installerade på datorn.

Cmdleten Update-Help introducerades i Windows PowerShell 3.0. Det fungerar inte i tidigare versioner av PowerShell. På datorer som har både Windows PowerShell 2.0 och Windows PowerShell 3.0 använder du cmdleten Update-Help i en Windows PowerShell 3.0-session för att ladda ned och uppdatera hjälpfiler. Hjälpfilerna är tillgängliga för både Windows PowerShell 2.0 och Windows PowerShell 3.0.

Cmdletarna Update-Help och Save-Help använder följande portar för att ladda ned hjälpfiler: Port 80 för HTTP och port 443 för HTTPS.

Update-Help stöder alla moduler och kärn snapin-moduler i PowerShell. Det stöder inte andra snapin-moduler.

Om du vill uppdatera hjälpen för en modul på en plats som inte finns med i $env:PSModulePath miljövariabeln importerar du modulen till den aktuella sessionen och kör sedan ett Update-Help kommando. Kör Update-Help utan parametrar eller använd parametern Module för att ange modulnamnet. Parametern Module för cmdletarna Update-Help och Save-Help accepterar inte den fullständiga sökvägen för en modulfil eller modulmanifestfil.

Alla moduler har stöd för uppdateringsbar hjälp. Anvisningar för stöd för uppdateringsbar hjälp i de moduler som du skapar finns i Support Updatable Help.

Cmdletarna Update-Help och Save-Help stöds inte i Windows Preinstallation Environment (Windows PE).