Update-Help

Referencia

Modul:: Microsoft.PowerShell.Core

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

Syntax

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

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 parancsmaggal Get-Help 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ájljai 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 Update-Help nélkül frissítse a frissíthető súgót támogató modulok súgófájljait, amelyek betöltve vannak a munkamenetbe, vagy telepítve vannak a $env:PSModulePath. 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 az adott modul súgófájljait.

Ha az operációs rendszer kulturális beállításai olyan nyelvre vannak konfigurálva, amely nem érhető el a frissíthető súgóhoz, Update-Help a súgó letöltése nélkül, csendben folytatódik. Az UICulture paraméterrel letöltheti a súgófájlokat egy támogatott nyelven. A területi beállításhoz mindig elérhető a en-US súgó.

Olyan számítógépeken is használhatja Update-Help , amelyek nem csatlakoznak az internethez. Először a parancsmaggal töltse le a Save-Helpsú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 SourcePath paraméter Update-Help használatával 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.

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\Modulesbeleértve a PowerShell Core-modulokat is) található modulok súgófájljainak letöltéséhez vagy frissítéséhez indítsa el a PowerShellt a Futtatás rendszergazdaként lehetőséggel. Például: Start-Process powershell.exe -Verb RunAs

A súgófájlok frissítéséhez használja a Windows PowerShell frissítése súgómenüelemét a Windows PowerShell integrált szkriptelési környezet (ISE) súgómenüjében.

A Windows PowerShell frissítése súgóelem paraméterek nélkül futtat egy Update-Help parancsmagot. A címtárban található modulok súgójának frissítéséhez indítsa el a $PSHOME Windows PowerShell ISE-t a Futtatás rendszergazdaként lehetőséggel.

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 Update-Help parancsmag csak a Microsoft.PowerShell-lel kezdődő modulnevek súgófájljait frissíti.

Update-Help -Module Microsoft.PowerShell*

3. példa: A súgó frissítése olyan rendszeren, amely nincs beállítva az 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 nem áll rendelkezésre súgó a rendszer által használt nyelvhez, csendben meghiúsul, Update-Help kivéve, ha a UICulture paramétert használja.

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

Update-Help Microsoft.PowerShell.Utility -Force
Update-Help Microsoft.PowerShell.Utility -Force -UICulture en-GB

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}.
At line:1 char:1
+ Update-Help Microsoft.PowerShell.Utility -Force -UICulture en-GB
+ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
    + CategoryInfo          : InvalidOperation: (:) [Update-Help], Exception
    + FullyQualifiedErrorId : HelpCultureNotSupported,Microsoft.PowerShell.Commands
   .UpdateHelpCommand

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

4. példa: Súgófájlok automatikus frissítése

Ez a példa egy ütemezett feladatot hoz létre, amely minden nap 3:00-kor frissíti az összes modul súgóját.

$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

A Register-ScheduledJob parancsmag létrehoz egy ütemezett feladatot, amely parancsot Update-Help futtat. A parancs a Hitelesítő adatok paramétert használja a számítógép Rendszergazdák csoportjának egy tagjának hitelesítő adataival való futtatásához Update-Help . Az eseményindító paraméter értéke egy New-JobTrigger olyan parancs, amely létrehoz egy feladat-eseményindítót, amely minden nap 3:00-kor elindítja a feladatot.

A parancs futtatásához indítsa el a Register-ScheduledJob PowerShellt a Futtatás rendszergazdaként lehetőséggel. A PowerShell kéri a hitelesítőadat-paraméterben megadott felhasználó jelszavát. A hitelesítő adatokat az ütemezett feladat tárolja. A rendszer nem kéri a feladat futtatásakor.

A Get-ScheduledJob parancsmaggal megtekintheti az ütemezett feladatot, módosíthatja a Set-ScheduledJob parancsmagot, és törölheti a Unregister-ScheduledJob parancsmagot. Az ütemezett feladatot a Tevékenységütemezőben is megtekintheti és kezelheti az alábbi elérési úton:

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

5. 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ájlmegosztásban lévő \\Server01\Share\PSHelp fájlokat. A Hitelesítőadat paraméter egy olyan felhasználót határoz meg, aki jogosult hozzáférni a fájlmegosztáshoz.

A Invoke-Command parancsmag több számítógépen futtat távoli Update-Help parancsokat. 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őadat paraméter egy olyan felhasználót határoz meg, aki hozzáférhet a fájlmegosztáshoz, és futtathatja a távoli Update-Help parancsot.

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

A Update-Help parancsmag frissítési súgója egy adott modulhoz. A parancsmag a Részletes gyakori paraméter használatával jeleníti meg a frissített súgófájlok listáját. A Verbose 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 Update-Help nélkül nem jelenik meg a parancs eredménye. 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

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

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

Ebben a példában a szkript Get-UpdateHelpVersion.ps1 létrehozza az egyes modulok frissíthető súgófájljainak és verziószámainak leltárát.

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), hogy megtalálja a legújabb verziószámot.

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

Jóváhagyást kér a parancsmag futtatása előtt.

Típus:	SwitchParameter
Aliasok:	cf
Position:	Named
Alapértelmezett érték:	False
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-Credential

Megadja annak a felhasználónak a hitelesítő adatait, aki engedéllyel rendelkezik a SourcePath által megadott fájlrendszer-hely eléréséhez. Ez a paraméter csak akkor érvényes, ha a SourcePath vagy a LiteralPath paramétert használja a parancs.

A Hitelesítő adat paraméterrel parancsokat futtathat Update-Help a SourcePath paraméterrel távoli számítógépeken. 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 írjon be egy PSCredential objektumot, amelyet a Get-Credential parancsmag hoz létre. Ha beír egy felhasználónevet, a rendszer kéri a jelszó megadását.

A hitelesítő adatokat PSCredential objektum tárolja, a jelszót pedig SecureStringként tárolja a rendszer.

Feljegyzés

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

Típus:	PSCredential
Position:	Named
Alapértelmezett érték:	Current user
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	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.

A paraméter Update-Help nélkül 24 órás időszakokban 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 egy 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 több felhasználói felületi kultúrában, 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

Típus:	SwitchParameter
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	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 egy név vagy egy modul specifikációja, a PowerShell megkeresi a PSModulePath-t a megadott modulban.

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

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

A Modul paraméterrel azonos parancsban nem adhatja meg a Teljesképűmodule paramétert.

Típus:	ModuleSpecification[]
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	True
Helyettesítő karakterek elfogadása:	False

-LiteralPath

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

A címtárobjektumok (például a parancsmagok vagy Get-ChildItem parancsmagok) folyamatának folyamata a következőre Update-Helpmutat: .Get-Item>

A SourcePath értékével ellentétben a LiterálPath é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 út tartalmaz escape karaktereket, csatolja egy idézőjelek közé. Az idézőjelek azt mondják a PowerShellnek, hogy ne értelmezzen karaktereket feloldósorozatként.

Típus:	String[]
Aliasok:	PSPath
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	True
Helyettesítő karakterek elfogadása:	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 parancsmagból a Get-Module 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 környezeti változóban $env:PSModulePath felsorolt helyen van telepítve.

A számítógépen telepített összes modul súgójának * frissítésére tett (mind) érték. 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 Modul paramétere Update-Help nem fogadja el a modulfájl vagy a moduljegyzékfájl teljes elérési útját. Ha nem egy helyen található modul $env:PSModulePath súgóját szeretné frissíteni, importálja a modult az aktuális munkamenetbe a Update-Help parancs futtatása előtt.

Típus:	String[]
Aliasok:	Name
Position:	0
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	True
Helyettesítő karakterek elfogadása:	True

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

Típus:	SwitchParameter
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-SourcePath

Egy fájlrendszermappát ad meg, amely Update-Help ahelyett, hogy letölti őket az internetről, frissített súgófájlokat kapna. Adja meg egy mappa elérési útját. Ne adjon meg fájlnevet vagy fájlnévkiterjesztést. Egy mappát, például egy parancsmagot a parancsmagokból Get-Item Get-ChildItem is folyamatba Update-Helphelyezhet.

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

A SourcePath alapértelmezett értékének megadásához válassza a Csoportházirend, a Számítógép konfigurációja és az Update-Súgó alapértelmezett forrásútvonalának beállítása lehetőséget. Ez a csoportházirend-beállítás megakadályozza, hogy a felhasználók Update-Help súgófájlokat töltsenek le az internetről. További információért lásd: about_Group_Policy_Settings.

Típus:	String[]
Position:	1
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-UICulture

A frissített súgófájlok lekéréséhez használt felhasználói felületi kulturális értékeket Update-Help adja meg. Adjon meg egy vagy több nyelvi kódot, például az es-ES-t, egy kulturális objektumokat tartalmazó változót vagy egy kulturális objektumokat lekérő parancsot, például egy vagy Get-UICulture egy Get-Culture parancsot. A helyettesítő karakterek nem engedélyezettek, és nem küldhet be részleges nyelvi kódot, például de.

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

Az UICulture paramétert használó parancsok csak akkor sikeresek, ha a modul súgófájlokat biztosít a megadott felhasználói felületi kultúrához. Ha a parancs meghiúsul, mert a megadott felhasználói felületi kultúra nem támogatott, hibaüzenet jelenik meg.

Típus:	CultureInfo[]
Position:	2
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	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.

Típus:	SwitchParameter
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-WhatIf

Bemutatja, mi történne a parancsmag futtatásakor. A parancsmag nem fut.

Típus:	SwitchParameter
Aliasok:	wi
Position:	Named
Alapértelmezett érték:	False
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

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 fő moduljainak súgóját, amely tartalmazza a PowerShell-lel telepített parancsokat vagy a $PSHOME\Modules címtár bármely modulját, indítsa el a PowerShellt rendszergazdaként való futtatás 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 például (Get-Command Update-Help).ModuleNamea Get-Command parancsmag ModuleName tulajdonságát.

Mivel a súgófájlok a modulkönyvtárban vannak telepítve, a parancsmag csak a Update-Help számítógépre telepített modulokhoz telepíthet 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 Update-Help Windows PowerShell 3.0-munkamenet 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 parancsmagok és Save-Help a 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 modulparaméter és Save-Help a Update-Help parancsmagok nem fogadják 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 útmutatásért tekintse meg az Frissíthető súgó támogatása című témakört.

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

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

Update-Help

Syntax

Description

Példák

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

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

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

4. példa: Súgófájlok automatikus frissítése

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

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

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

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

Paraméterek

-Confirm

-Credential

-Force

-FullyQualifiedModule

-LiteralPath

-Module

-Recurse

-SourcePath

-UICulture

-UseDefaultCredentials

-WhatIf

Bevitelek

Kimenetek

Jegyzetek

További források

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

Update-Help

Syntax

Description

Példák

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

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

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

4. példa: Súgófájlok automatikus frissítése

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

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

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

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

Paraméterek

-Confirm

-Credential

-Force

-FullyQualifiedModule

-LiteralPath

-Module

-Recurse

-SourcePath

-UICulture

-UseDefaultCredentials

-WhatIf

Bevitelek

Kimenetek

Jegyzetek

Kapcsolódó hivatkozások

További források