Megosztás a következőn keresztül:

Update-Help

Modul:
Microsoft.PowerShell.Core Module

Letölti és telepíti a legújabb súgófájlokat a számítógépre.

Syntax

Path (Alapértelmezett) 

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

LiteralPath 

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

Description

A Update-Help parancsmag letölti a PowerShell-modulok legújabb súgófájljait, és telepíti őket a számítógépre. A módosítás hatékonyságának eléréséhez nem kell újraindítania a PowerShellt. A Get-Help parancsmaggal azonnal megtekintheti az új súgófájlokat.

Update-Help ellenőrzi a számítógépen található súgófájlok verzióját. Ha nem rendelkezik súgófájlokkal egy modulhoz, vagy ha a súgófájlok elavultak, Update-Help letölti a legújabb súgófájlokat. A súgófájlok letölthetők és telepíthetők az internetről vagy egy fájlmegosztásból.

Paraméterek nélkül Update-Help frissíteni a frissíthető súgót támogató modulok súgófájljait, amelyek betöltve vannak a munkamenetbe, vagy a $Env:PSModulePathtalálható helyre vannak telepítve. További információ: about_Updatable_Help.

Update-Help ellenőrzi a telepített súgó verzióját. Ha Update-Help nem talál frissített súgófájlokat egy modulhoz, a hibaüzenet megjelenítése nélkül is csendben folytatódik. A verzióellenőrzés kihagyásához használja a Force paramétert. Az állapot és a folyamat részleteinek megtekintéséhez használja a Részletes paramétert. A Modul paraméterrel frissítheti egy adott modul súgófájljait.

Az Update-Help olyan számítógépeken is használhatja, amelyek nem csatlakoznak az internethez. Először a Save-Helpparancsmaggal töltse le a súgófájlokat az internetről, és mentse őket egy megosztott mappába, amely elérhető az internethez nem csatlakozó rendszer számára. Ezután a Update-Help paraméterével töltse le a frissített súgófájlokat a megosztott fájlból, és telepítse őket a számítógépre.

A Update-Help parancsmag a Windows PowerShell 3.0-ban lett bevezetve.

Fontos

Update-Help rendszergazdai jogosultságokat igényel a PowerShell 6.0-s és újabb verzióban. A PowerShell 6.1 és újabb verziókban állítsa az alapértelmezett HatókörCurrentUserértékre. A PowerShell 6.1 előtt a Hatókör paraméter nem volt elérhető.

Az alapvető PowerShell-modulok súgófájljainak frissítéséhez a számítógépen a Rendszergazdák csoport tagjának kell lennie.

A PowerShell telepítési könyvtárában ($PSHOME\Modules) található modulok súgófájljainak letöltéséhez vagy frissítéséhez , beleértve a PowerShell Core-modulokat is, indítsa el a PowerShellt a Rendszergazdai beállítással. Például: Start-Process pwsh.exe -Verb RunAs.

Példák

1. példa: Súgófájlok frissítése az összes modulhoz

A Update-Help parancsmag frissíti az frissíthető súgót támogató telepített modulok súgófájljait. A felhasználói felület (UI) kulturális nyelve az operációs rendszerben van beállítva.

Update-Help

2. példa: A megadott modulok súgófájljainak frissítése

A parancsmag frissítései csak a Microsoft.PowerShellkezdődő modulnevek fájljait segítik.

Update-Help -Module Microsoft.PowerShell*

3. példa: A súgó frissítése olyan rendszeren, amely nincs beállítva a en-US területi beállításra

A Update-Help parancsmagot úgy tervezték, hogy több nyelven is letöltse a súgót. Ha azonban a rendszer által használt nyelvhez nem áll rendelkezésre súgó, hibaüzenet jelenik meg a modul és a felhasználói felületi kultúra számára.

Ebben a példában Update-Help egy olyan rendszeren fut, amely a en-GB területi beállításra van állítva.

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.

A súgófájlok mindig közzé vannak téve a en-US területi beállításhoz. Az angol nyelvű súgó letöltéséhez futtassa a Update-Help paraméterrel , és adja meg a en-US területi beállításokat.

4. példa: Súgófájlok frissítése több számítógépen fájlmegosztásból

Ebben a példában a frissített súgófájlok az internetről töltődnek le, és fájlmegosztásba vannak mentve. Olyan felhasználói hitelesítő adatokra van szükség, amelyek rendelkeznek a fájlmegosztás elérésére és a frissítések telepítésére vonatkozó engedélyekkel. Fájlmegosztás használata esetén frissíthetők a tűzfal mögötti vagy az internethez nem csatlakozó számítógépek.

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
}

A Save-Help parancs letölti az frissíthető súgót támogató összes modul legújabb súgófájljait. A DestinationPath paraméter menti a fájlokat a \\Server01\Share\PSHelp fájlmegosztásba. A Hitelesítő adatok paraméter olyan felhasználót határoz meg, aki jogosult hozzáférni a fájlmegosztáshoz.

A Invoke-Command parancsmag távoli Update-Help parancsokat futtat több számítógépen. A ComputerName paraméter lekéri a távoli számítógépek listáját a Servers.txt fájlból. A ScriptBlock paraméter futtatja a Update-Help parancsot, és a SourcePath paraméter használatával adja meg a frissített súgófájlokat tartalmazó fájlmegosztást. A Hitelesítő adatok paraméter megadja azt a felhasználót, aki hozzáférhet a fájlmegosztáshoz, és futtathatja a távoli Update-Help parancsot.

5. példa: Frissített súgófájlok listájának lekérése

A Update-Help parancsmag frissítései segítenek egy adott modulban. A parancsmag a Részletes gyakori paramétert használja a frissített súgófájlok listájának megjelenítéséhez. A Részletes használatával megtekintheti egy adott modul összes súgófájljának vagy súgófájljának kimenetét.

A Részletes paraméter nélkül Update-Help nem jeleníti meg a parancs eredményeit. A Részletes paraméter kimenete hasznos annak ellenőrzéséhez, hogy a súgófájlok frissültek-e, vagy hogy telepítve van-e a legújabb verzió.

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

6. példa: Frissíthető súgót támogató modulok keresése

Ez a példa az frissíthető súgót támogató modulokat sorolja fel. A parancs a modul HelpInfoUri tulajdonságával azonosítja az frissíthető súgót támogató modulokat. A HelpInfoUri tulajdonság olyan URL-címet tartalmaz, amely a Update-Help parancsmag futtatásakor lesz átirányítva.

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

7. példa: Leltárban frissített súgófájlok

Ebben a példában a szkript Get-UpdateHelpVersion.ps1 létrehoz egy leltárt az egyes modulok frissíthető súgófájljairól és verziószámukról.

A szkript azonosítja azokat a modulokat, amelyek támogatják az frissíthető súgót a modulok HelpInfoUri tulajdonságával. Az frissíthető súgót támogató modulok esetében a szkript megkeresi és elemzi a súgóinformációs fájlt (*helpinfo.xml) a legújabb verziószám megkereséséhez.

A szkript a PSCustomObject osztályt és egy kivonattáblát használ egy egyéni kimeneti objektum létrehozásához.

# 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

Paraméterek

-Confirm

Megerősítést kér a parancsmag futtatása előtt.

Paramétertulajdonságok

Típus:SwitchParameter
Alapértelmezett érték:False
Támogatja a helyettesítő karaktereket:False
DontShow:False
Aliasok:Cf

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

-Credential

Olyan felhasználó hitelesítő adatait adja meg, aki jogosult hozzáférni a SourcePatháltal megadott fájlrendszer-helyhez. Ez a paraméter csak akkor érvényes, ha a parancs a SourcePath vagy LiteralPath paramétert használja.

A Hitelesítő adatok paraméterrel távoli számítógépeken futtathat Update-Help parancsokat a SourcePath paraméterrel. Explicit hitelesítő adatok megadásával futtathatja a parancsot egy távoli számítógépen, és hozzáférhet egy fájlmegosztáshoz egy harmadik számítógépen anélkül, hogy hozzáférés-megtagadási hibát tapasztalna, vagy a hitelesítő adatok delegálásához CredSSP-hitelesítést használna.

Írjon be egy felhasználónevet, például User01 vagy Domain01\User01, vagy adjon meg egy PSCredential objektumot, amelyet a Get-Credential parancsmag generál. Ha beír egy felhasználónevet, a rendszer kéri a jelszó megadását.

A hitelesítő adatokat egy PSCredential objektum tárolja, a jelszó pedig SecureString.

Megjegyzés:

További információért a SecureString adatvédelemről lásd: Mennyire biztonságos a SecureString?.

Paramétertulajdonságok

Típus:PSCredential
Alapértelmezett érték:Current user
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

-Force

Azt jelzi, hogy ez a parancsmag nem követi a napi egyszeri korlátozást, kihagyja a verzióellenőrzést, és letölti az 1 GB-os korlátot meghaladó fájlokat.

E paraméter nélkül Update-Help 24 óránként csak egyszer fut. A letöltések modulonként legfeljebb 1 GB tömörítetlen tartalomra korlátozódnak, és a súgófájlok csak akkor települnek, ha újabbak, mint a számítógépen meglévő fájlok.

A napi egyszeri korlát védi a súgófájlokat üzemeltető kiszolgálókat, és praktikussá teszi, hogy Update-Help parancsot adjon hozzá a PowerShell-profiljához anélkül, hogy az ismétlődő kapcsolatok vagy letöltések erőforrásköltsége felmerül.

Ha a Force paraméter nélkül szeretne frissíteni egy modul súgóját, az összes felhasználói felületi kultúrát ugyanabba a parancsba kell foglalnia, például:

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

Paramétertulajdonságok

Típus:SwitchParameter
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

-FullyQualifiedModule

Az érték lehet egy modul neve, egy teljes modul specifikációja vagy egy modulfájl elérési útja.

Ha az érték egy elérési út, az elérési út teljes mértékben minősített vagy relatív lehet. A relatív elérési út feloldása a használandó utasítást tartalmazó szkripthez képest történik.

Ha az érték név vagy modulspecifikáció, a PowerShell megkeresi a megadott modul PSModulePath.

A modulspecifikáció egy kivonatoló, amely a következő kulcsokkal rendelkezik.

  • ModuleName - Kötelező A modul nevét adja meg.
  • GUID - Nem kötelező A modul GUID azonosítóját adja meg.
  • Emellett Kötelező megadni az alábbi három kulcs közül legalább egyet.
    • ModuleVersion – A modul minimálisan elfogadható verzióját adja meg.
    • MaximumVersion – A modul maximálisan elfogadható verzióját adja meg.
    • RequiredVersion – A modul pontos, kötelező verzióját adja meg. Ez nem használható a többi Verzió billentyűvel.

Nem adhatja meg a Teljesen minősített modul paramétert ugyanabban a parancsban, mint egy Modul paraméter.

Paramétertulajdonságok

Típus:

ModuleSpecification[]

Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:True
Fennmaradó argumentumokból származó érték:False

-LiteralPath

A frissített súgófájlok mappáját adja meg az internetről való letöltés helyett. Használja ezt a paramétert vagy SourcePath, ha a Save-Help parancsmaggal letöltötte a súgófájlokat egy könyvtárba.

A címtárobjektumokat( például a Get-Item vagy Get-ChildItem parancsmagokat) a Update-Help.

A SourcePathértékétől eltérően a LiteralPath értéke pontosan a beírt módon lesz használva. A rendszer egyetlen karaktert sem értelmez helyettesítő karakterként. Ha az elérési útvonal escape karaktereket tartalmaz, tedd azt egyes idézőjelek közé. Az egyes idézőjelek azt mondják a PowerShellnek, hogy egyetlen karaktert se értelmezzen escape szekvenciaként.

Paramétertulajdonságok

Típus:

String[]

Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False
Aliasok:PSPath, LP

Paraméterkészletek

LiteralPath
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:True
Fennmaradó argumentumokból származó érték:False

-Module

A megadott modulok frissítési súgója. Adjon meg egy vagy több modulnevet vagy névmintát egy vesszővel tagolt listában, vagy adjon meg egy olyan fájlt, amely minden sorban egy modulnevet sorol fel. A helyettesítő karakterek használata engedélyezett. A modulokat a Get-Module parancsmagból a Update-Help parancsmagba is folyamatba helyezheti.

A megadott modulokat telepíteni kell a számítógépre, de nem kell importálni őket az aktuális munkamenetbe. Megadhatja a munkamenet bármely modulját, vagy bármely olyan modult, amely a $Env:PSModulePath környezeti változóban felsorolt helyen van telepítve.

A * (mind) megkísérli frissíteni a számítógépen telepített összes modul súgóját. Az frissíthető súgót nem támogató modulok is elérhetők. Ez az érték hibákat eredményezhet, ha a parancs olyan modulokkal találkozik, amelyek nem támogatják az frissíthető súgót. Ehelyett futtassa Update-Help paraméterek nélkül.

A parancsmag Update-Help paramétere nem fogadja el a modulfájl vagy a moduljegyzékfájl teljes elérési útját. Ha olyan modul súgóját szeretné frissíteni, amely nem $Env:PSModulePath helyen található, importálja a modult az aktuális munkamenetbe a Update-Help parancs futtatása előtt.

Paramétertulajdonságok

Típus:

String[]

Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:True
DontShow:False
Aliasok:Név

Paraméterkészletek

(All)
Position:0
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:True
Fennmaradó argumentumokból származó érték:False

-Recurse

Rekurzív keresést végez a megadott könyvtár súgófájljaiban. Ez a paraméter csak akkor érvényes, ha a parancs a SourcePath paramétert használja.

Paramétertulajdonságok

Típus:SwitchParameter
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

-Scope

Megadja a rendszer hatókörét, ahol a súgó frissül. A AllUsers hatókörének frissítései rendszergazdai jogosultságokat igényelnek a Windows-rendszereken. A -Scope paraméter a PowerShell Core 6.1-es verziójában lett bevezetve.

CurrentUser a PowerShell 6.1-ben és újabb verziókban található súgófájlok alapértelmezett hatóköre. AllUsers az összes felhasználó súgójának telepítéséhez vagy frissítéséhez adható meg. A Unix-rendszereken sudo jogosultságok szükségesek az összes felhasználó súgójának frissítéséhez. Például: sudo pwsh -c Update-Help

Az elfogadható értékek a következők:

  • Aktuális felhasználó
  • Összes felhasználó

Paramétertulajdonságok

Típus:UpdateHelpScope
Alapértelmezett érték:CurrentUser
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:True
Fennmaradó argumentumokból származó érték:False

-SourcePath

Megadja azt a fájlrendszermappát, amelyben Update-Help az internetről való letöltés helyett frissíti a súgófájlokat. Adja meg egy mappa elérési útját. Ne adjon meg fájlnevet vagy fájlnévkiterjesztést. A Get-Item vagy Get-ChildItem parancsmagokból is folyamatba helyezhet egy mappát a Update-Help.

Alapértelmezés szerint Update-Help letölti a frissített súgófájlokat az internetről. Ha a parancsmaggal frissített súgófájlokat tölt le egy könyvtárba, használja Save-Help.

A SourcePathalapértelmezett értékének megadásához lépjen csoportházirend-, számítógép konfigurációs, és Adja meg az Update-Helpalapértelmezett forrásútvonalát. Ez a csoportházirend-beállítás megakadályozza, hogy a felhasználók Update-Help segítségével töltsenek le súgófájlokat az internetről. Ha további információra van szüksége, lásd: about_Group_Policy_Settings.

Paramétertulajdonságok

Típus:

String[]

Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False
Aliasok:Útvonal

Paraméterkészletek

Path
Position:1
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

-UICulture

Megadja azokat a felhasználói felületi kulturális értékeket, amelyekhez ez a parancsmag frissül a súgófájlokban. Adjon meg egy vagy több nyelvi kódot, például es-ES, kulturális objektumokat tartalmazó változót, vagy egy kulturális objektumokat lekérő parancsot, például egy Get-Culture vagy Get-UICulture parancsot. A helyettesítő karakterek nem engedélyezettek.

Alapértelmezés szerint Update-Help az operációs rendszerhez vagy tartalék kultúrához beállított felhasználói felületi kultúra súgófájljait kapja meg. Ha megadja a UICulture paramétert, Update-Help csak a megadott nyelvhez keres segítséget.

A PowerShell 7.4-től kezdve használhat egy részleges nyelvi kódot, például en a súgó angol nyelvű letöltéséhez bármely régióhoz.

Megjegyzés:

Az Ubuntu 18.04 az alapértelmezett területi beállítást C.UTF.8értékre módosította, amely nem elismert felhasználói felületi kultúra. Update-Help csendben nem tölt le súgót, hacsak nem használja ezt a paramétert egy támogatott területi beállítással, például en-US. Ez bármely olyan platformon előfordulhat, amely nem támogatott értéket használ.

Paramétertulajdonságok

Típus:

CultureInfo[]

Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

(All)
Position:2
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

-UseDefaultCredentials

Azt jelzi, hogy Update-Help az aktuális felhasználó hitelesítő adataival futtatja a parancsot, beleértve az internetes letöltést is. A parancs alapértelmezés szerint explicit hitelesítő adatok nélkül fut.

Ez a paraméter csak akkor érvényes, ha a webes letöltés NT LAN Manager (NTLM), egyeztetés vagy Kerberos-alapú hitelesítést használ.

Paramétertulajdonságok

Típus:SwitchParameter
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

-WhatIf

Megjeleníti, mi történne, ha a parancsmag futna. A parancsprogram nem lett futtatva.

Paramétertulajdonságok

Típus:SwitchParameter
Alapértelmezett érték:False
Támogatja a helyettesítő karaktereket:False
DontShow:False
Aliasok:Wi

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

CommonParameters

Ez a parancsmag a következő gyakori paramétereket támogatja: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction és -WarningVariable. További információért lásd about_CommonParameters.

Bevitelek

DirectoryInfo

Ehhez a parancsmaghoz egy könyvtárútvonal-objektumot is csövezhet.

PSModuleInfo

Ehhez a parancsmaghoz modulobjektumot is csövezhet.

Kimenetek

None

Ez a parancsmag nem ad vissza kimenetet.

Jegyzetek

Ha frissíteni szeretné a PowerShell-lel telepített fő PowerShell-modulok vagy a $PSHOME\Modules könyvtár bármely moduljának súgóját, indítsa el a PowerShellt a rendszergazdai lehetőséggel.

A számítógépen csak a Rendszergazdák csoport tagjai frissíthetik az alapvető PowerShell-modulok, a PowerShell-lel együtt telepített parancsok és a $PSHOME\Modules mappában lévő modulok súgóját. Ha nincs engedélye a súgófájlok frissítésére, online is elolvashatja a súgófájlokat. Például: Get-Help Update-Help -Online.

A modulok az frissíthető súgó legkisebb egysége. Egy adott parancsmag súgója nem frissíthető. Az adott parancsmagot tartalmazó modul megkereséséhez használja a parancsmag Get-Command tulajdonságát, például (Get-Command Update-Help).ModuleName.

Mivel a súgófájlok a modulkönyvtárban vannak telepítve, a Update-Help parancsmag csak a számítógépre telepített modulokra képes telepíteni a frissített súgófájlt. A Save-Help parancsmag azonban menthet segítséget a nem a számítógépre telepített modulokhoz.

A Update-Help parancsmag a Windows PowerShell 3.0-ban lett bevezetve. A PowerShell korábbi verzióiban nem működik. Windows PowerShell 2.0 és Windows PowerShell 3.0 rendszerű számítógépeken a Windows PowerShell 3.0-munkamenet Update-Help parancsmagja segítségével töltse le és frissítse a súgófájlokat. A súgófájlok a Windows PowerShell 2.0 és a Windows PowerShell 3.0 rendszerben is elérhetők.

A Update-Help és Save-Help parancsmagok a következő portokat használják a súgófájlok letöltéséhez: 80-os port HTTP-hez és 443-os port HTTPS-hez.

Update-Help támogatja az összes modult és az alapvető PowerShell-beépülő modulokat. Más beépülő modulokat nem támogat.

Ha olyan helyen szeretné frissíteni a modul súgóját, amely nem szerepel a $Env:PSModulePath környezeti változóban, importálja a modult az aktuális munkamenetbe, majd futtasson egy Update-Help parancsot. Futtassa Update-Help paraméterek nélkül, vagy használja a Modul paramétert a modul nevének megadásához. A és Update-Help parancsmagok Save-Help paramétere nem fogadja el a modulfájl vagy a moduljegyzékfájl teljes elérési útját.

Bármely modul támogatja az frissíthető súgót. Az frissíthető súgónak az Ön által létrehozott modulokban való támogatásával kapcsolatos utasításokat a Frissíthető súgó támogatásacímű témakörben találja.

A Update-Help és Save-Help parancsmagok nem támogatottak a Windows előtelepítési környezetében (Windows PE).