Update-Help
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]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
LiteralPath
Update-Help
[[-Module] <String[]>]
[[-UICulture] <CultureInfo[]>]
[-FullyQualifiedModule <ModuleSpecification[]>]
[-LiteralPath <String[]>]
[-Recurse]
[-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 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íti a munkamenet moduljainak súgófájljait és az frissíthető súgót támogató összes telepített modult. Az aktuális munkamenetben telepített, de nem betöltött modulok is szerepelnek benne. A PowerShell-modulok a $env:PSModulePath környezeti változóban felsorolt helyen vannak tárolva.
További információ: about_Updatable_Help.
A Modul paraméterrel frissítheti egy adott modul súgófájljait. A UICulture paraméter használatával több nyelven és területi beállításban tölthet le súgófájlokat.
Az Update-Help olyan számítógépeken is használhatja, amelyek nem csatlakoznak az internethez. A Save-Help parancsmaggal letöltheti a súgófájlokat az internetről, és mentheti őket egy fájlrendszerbeli helyre, például megosztott mappába vagy fájlrendszerkönyvtárba. Ezután a Update-Help paraméterével töltse le a frissített súgófájlokat egy fájlrendszer helyről, és telepítse őket a számítógépre.
A súgófrissítések automatizálásához adja hozzá a Update-Help parancsmagot a PowerShell-profiljához. Alapértelmezés szerint Update-Help naponta csak egyszer fut minden számítógépen. A napi egyszeri korlát felülbírálásához használja a Force paramétert.
A Update-Help parancsmag a Windows PowerShell 3.0-ban lett bevezetve.
Fontos
Update-Help rendszergazdai jogosultságokat igényel.
A PowerShell Core-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 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 egy Update-Help parancsmagot futtat paraméterek nélkül.
A $PSHOME könyvtár moduljainak súgójának frissítéséhez indítsa el a 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 -Module Microsoft.PowerShell*
3. példa: Súgófájlok frissítése különböző nyelvekhez
A Update-Help parancsmag frissíti az összes modul japán (ja-JP) és angol (en-US) súgófájljait.
Ha egy modul nem biztosít súgófájlokat egy adott felhasználói felületi kultúrához, hibaüzenet jelenik meg a modulhoz és a felhasználói felületi kultúrához. Ebben a példában a hibaüzenet azt jelzi, hogy a ja-JP súgófájljai nem találhatók a Microsoft.PowerShell.Utility modulhoz.
Update-Help -UICulture ja-JP, en-US
Update-Help : Failed to update Help for the module(s) 'Microsoft.PowerShell.Utility' with UI culture(s) {ja-JP}
No UI culture was found that matches the following pattern: ja-JP.
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 egy Update-Help parancsot futtat. A parancs a Hitelesítő adatok paraméterrel futtatja a Update-Help a számítógépen a Rendszergazdák csoport egyik tagjának hitelesítő adataival. A Trigger paraméter értéke egy New-JobTrigger parancs, amely létrehoz egy feladatindítót, amely minden nap 3:00-kor elindítja a feladatot.
A Register-ScheduledJob parancs futtatásához indítsa el a PowerShellt a Futtatás rendszergazdaként beállítással. A PowerShell kéri a Hitelesítő adatok 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.
Az 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.
PS> Save-Help -DestinationPath \\Server01\Share\PSHelp -Credential Domain01\Admin01
PS> Invoke-Command -ComputerName (Get-Content Servers.txt) -ScriptBlock {
Update-Help -SourcePath \\Server01\Share\PSHelp -Credential Domain01\Admin01
}
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 a Update-Help parancsot futtatja, é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.
6. 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
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 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é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='https://schemas.microsoft.com/powershell/help/2010/05'}
if ($Module) { $Modules = Get-Module $Module -ListAvailable | where {$_.HelpInfoUri} }
else { $Modules = Get-Module -ListAvailable | where {$_.HelpInfoUri} }
foreach ($mModule in $Modules)
{
$mDir = $mModule.ModuleBase
if (Test-Path $mdir\*helpinfo.xml)
{
$mName=$mModule.Name
$mNodes = dir $mdir\*helpinfo.xml -ErrorAction SilentlyContinue |
Select-Xml -Namespace $HelpInfoNamespace -XPath "//helpInfo:UICulture"
foreach ($mNode in $mNodes)
{
$mCulture=$mNode.Node.UICultureName
$mVer=$mNode.Node.UICultureVersion
[PSCustomObject]@{"ModuleName"=$mName; "Culture"=$mCulture; "Version"=$mVer}
}
}
}
ModuleName Culture Version
---------- ------- -------
ActiveDirectory en-US 3.0.0.0
ADCSAdministration en-US 3.0.0.0
ADCSDeployment en-US 3.0.0.0
ADDSDeployment en-US 3.0.0.0
ADFS en-US 3.0.0.0
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.
Paramétertulajdonságok
| Típus: | PSCredential |
| 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 |
-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
Olyan modulokat határoz meg, amelyek neve ModuleSpecification objektumok formájában van megadva. Ezeket a modulokat ModuleSpecification Constructor (Hashtable)Megjegyzések szakaszában találja.
A FullyQualifiedModule paraméter például a következő formátumban megadott modulnevet fogadja el:
@{ModuleName = "modulename"; ModuleVersion = "version_number"}
vagy
@{ModuleName = "modulename"; ModuleVersion = "version_number"; Guid = "GUID"}.
ModuleName és ModuleVersion szükséges, de Guid megadása nem kötelező.
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 |
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. A munkamenetben bármely modult megadhatja, 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 |
-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 SourcePathUpdate-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 |
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
A felhasználói felület kulturális értékeit adja meg, amelyeket Update-Help használ a frissített súgófájlok lekéréséhez. Adjon meg egy vagy több nyelvkó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, é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 a UICulture paramétert, Update-Help csak a megadott felhasználói felületi kultúrához keres segítséget.
A 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.
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
A címtár elérési útját a Update-Help.
PSModuleInfo
A modulobjektumokat a Get-Module parancsmagból Update-Help.
Kimenetek
None
Update-Help nem hoz létre kimenetet.
Jegyzetek
Ha frissíteni szeretné a PowerShell Core-modulok súgóját, amely tartalmazza a PowerShell-lel telepített parancsokat, vagy a $PSHOME\Modules könyvtár bármely modulját, indítsa el a PowerShellt azzal a beállítással, hogy rendszergazdai.
A PowerShell Core-modulok, a PowerShell-lel együtt telepített parancsok és a $PSHOME\Modules mappában lévő modulok súgóját csak a számítógépen található Rendszergazdák csoport tagjai frissíthetik. 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.
Ha Update-Help nem talál frissített súgófájlokat egy modulhoz, vagy nem találja a frissített súgót a megadott nyelven, a hibaüzenet megjelenítése nélkül is csendben folytatódik. Az állapot és a folyamat részleteinek megtekintéséhez használja a Részletes paramétert.
A Update-Help parancsmag a Windows PowerShell 3.0-ban lett bevezetve. A Windows 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 a PowerShell Core 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).