Update-Help
Bilgisayarınıza en yeni yardım dosyalarını indirir ve yükler.
Sözdizimi
Path EnterprisePublishing
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
Update-Help cmdlet'i, PowerShell modülleri için en yeni yardım dosyalarını indirir ve bilgisayarınıza yükler. Değişikliği etkili hale getirmek için PowerShell'i yeniden başlatmanız gerekmez. Yeni yardım dosyalarını hemen görüntülemek için Get-Help cmdlet'ini kullanabilirsiniz.
Update-Help bilgisayarınızdaki yardım dosyalarının sürümünü denetler. Bir modül için yardım dosyalarınız yoksa veya yardım dosyalarınız güncel değilse Update-Help en yeni yardım dosyalarını indirir. Yardım dosyaları internetten veya dosya paylaşımından indirilebilir ve yüklenebilir.
Parametreler olmadan, Update-Help güncelleştirilebilir yardımı destekleyen ve oturuma yüklenen veya $Env:PSModulePathiçinde bulunan bir konuma yüklenen modüller için yardım dosyalarını güncelleştirir. Daha fazla bilgi için bkz. about_Updatable_Help.
Update-Help yüklü yardımın sürümünü denetler.
Update-Help bir modül için güncelleştirilmiş yardım dosyalarını bulamazsa, bir hata iletisi görüntülemeden sessizce devam eder. Sürüm denetimini atlamak için Zorla parametresini kullanın. Durum ve ilerleme ayrıntılarını görmek için Ayrıntılı parametresini kullanın. Belirli bir modülün yardım dosyalarını güncelleştirmek için Modülü parametresini kullanın.
İnternet'e bağlı olmayan bilgisayarlarda da Update-Help kullanabilirsiniz. İlk olarak, Save-Helpcmdlet'ini kullanarak yardım dosyalarını İnternet'ten indirin ve bunları İnternet'e bağlı olmayan sistem tarafından erişilebilen paylaşılan bir klasöre kaydedin. Ardından Update-Help parametresini kullanarak paylaşılan yardım dosyalarını indirip bilgisayara yükleyin.
Update-Help cmdlet'i Windows PowerShell 3.0'da kullanıma sunulmuştur.
Önemli
Update-Help, PowerShell 6.0 ve altında yönetim ayrıcalıkları gerektirir. PowerShell 6.1 ve üzeri varsayılan KapsamCurrentUserolarak ayarlayın. PowerShell 6.1'in öncesinde Kapsamı parametresi kullanılamıyordu.
Çekirdek PowerShell modüllerinin yardım dosyalarını güncelleştirmek için bilgisayardaki Yöneticiler grubunun üyesi olmanız gerekir.
PowerShell Core modülleri dahil olmak üzere PowerShell yükleme dizinindeki ($PSHOME\Modules) modüllerin yardım dosyalarını indirmek veya güncelleştirmek için, Yönetici olarak çalıştır seçeneğini kullanarak PowerShell'i başlatın. Örneğin: Start-Process pwsh.exe -Verb RunAs.
Örnekler
Örnek 1: Tüm modüller için yardım dosyalarını güncelleştirme
Update-Help cmdlet'i Güncelleştirilebilir Yardım'ı destekleyen yüklü modüller için yardım dosyalarını güncelleştirir. Kullanıcı arabirimi (UI) kültür dili işletim sisteminde ayarlanır.
Update-Help
Örnek 2: Belirtilen modüller için yardım dosyalarını güncelleştirme
Update-Help cmdlet'i yalnızca Microsoft.PowerShellile başlayan modül adlarıyla ilgili yardım dosyalarını güncelleştirir.
Update-Help -Module Microsoft.PowerShell*
Örnek 3: en-US yerel ayarına ayarlı olmayan bir sistemde yardım güncelleştiriliyor
Update-Help cmdlet'i birden çok dilde yardım indirmek için tasarlanmıştır. Ancak, sisteminizin kullandığı dil için kullanılabilir bir yardım olmadığında modül ve kullanıcı arabirimi kültürü için bir hata iletisi görüntülenir.
Bu örnekte, Update-Helpen-GB yerel ayarına ayarlanmış bir sistemde çalıştırılıyor.
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.
Yardım dosyaları her zaman en-US yerel ayarı için yayımlanır. İngilizce yardımını indirmek için Update-Help parametresiyle çalıştırın ve en-US yerel ayarını belirtin.
Örnek 4: Bir dosya paylaşımından birden çok bilgisayarda yardım dosyalarını güncelleştirme
Bu örnekte, güncelleştirilmiş yardım dosyaları İnternet'ten indirilir ve bir dosya paylaşımına kaydedilir. Dosya paylaşımına erişme ve güncelleştirmeleri yükleme izinlerine sahip kullanıcı kimlik bilgileri gereklidir. Dosya paylaşımı kullanıldığında, güvenlik duvarlarının arkasındaki veya İnternet'e bağlı olmayan bilgisayarları güncelleştirmek mümkündür.
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
}
Save-Help komutu Güncelleştirilebilir Yardımı destekleyen tüm modüller için en yeni yardım dosyalarını indirir.
DestinationPath parametresi, dosyaları \\Server01\Share\PSHelp dosya paylaşımına kaydeder.
Kimlik Bilgisi parametresi, dosya paylaşımına erişim izni olan bir kullanıcıyı belirtir.
Invoke-Command cmdlet'i birden çok bilgisayarda uzak Update-Help komutları çalıştırır.
ComputerName parametresi, Servers.txt dosyasından uzak bilgisayarların listesini alır.
ScriptBlock parametresi Update-Help komutunu çalıştırır ve güncelleştirilmiş yardım dosyalarını içeren dosya paylaşımını belirtmek için SourcePath parametresini kullanır.
Kimlik Bilgisi parametresi, dosya paylaşımına erişebilen ve uzak Update-Help komutunu çalıştırabilen bir kullanıcıyı belirtir.
Örnek 5: Güncelleştirilmiş yardım dosyalarının listesini alma
belirtilen modül için Update-Help cmdlet güncelleştirmeleri yardımı. Cmdlet, güncelleştirilen yardım dosyalarının listesini görüntülemek için Ayrıntılı ortak parametresini kullanır. Tüm yardım dosyalarının veya belirli bir modülün yardım dosyalarının çıktısını görüntülemek için Ayrıntılı kullanabilirsiniz.
Ayrıntılı parametresi olmadan Update-Help komutun sonuçlarını görüntülemez.
Ayrıntılı parametre çıkışı, yardım dosyalarının güncelleştirildiğini veya en son sürümün yüklü olup olmadığını doğrulamak için yararlıdır.
Update-Help -Module Microsoft.PowerShell.Utility -Verbose
Örnek 6: Güncelleştirilebilir Yardım'ı destekleyen modülleri bulma
Bu örnekte Güncelleştirilebilir Yardımı destekleyen modüller listelenir. Komut, Güncelleştirilebilir Yardımı destekleyen modülleri tanımlamak için modülün HelpInfoUri özelliğini kullanır.
HelpInfoUri özelliği, Update-Help cmdlet çalıştırıldığında yeniden yönlendirilen bir URL içerir.
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, ... }
Örnek 7: Güncelleştirilmiş yardım dosyalarının envanteri
Bu örnekte betik Get-UpdateHelpVersion.ps1 her modül için Güncelleştirilebilir Yardım dosyalarının ve bunların sürüm numaralarının envanterini oluşturur.
Betik, modüllerin HelpInfoUri özelliğini kullanarak Güncelleştirilebilir Yardımı destekleyen modülleri tanımlar. Güncelleştirilebilir Yardım'ı destekleyen modüller için betik, en son sürüm numarasını bulmak için yardım bilgileri dosyasını (*helpinfo.xml) arar ve ayrıştırılır.
Betik, özel bir çıkış nesnesi oluşturmak için PSCustomObject sınıfını ve karma tablosunu kullanır.
# 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
Parametreler
-Confirm
Cmdlet'i çalıştırmadan önce sizden onay ister.
Parametre özellikleri
| Tür: | SwitchParameter |
| Default value: | False |
| Joker karakterleri destekler: | False |
| DontShow: | False |
| Diğer adlar: | Cf |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-Credential
SourcePathtarafından belirtilen dosya sistemi konumuna erişim izni olan bir kullanıcının kimlik bilgilerini belirtir. Bu parametre yalnızca komutta SourcePath veya LiteralPath parametresi kullanıldığında geçerlidir.
Kimlik Bilgisi parametresi, uzak bilgisayarlarda Update-Help parametresiyle komutları çalıştırmanızı sağlar. Açık kimlik bilgileri sağlayarak uzak bir bilgisayarda komutunu çalıştırabilir ve üçüncü bir bilgisayardaki dosya paylaşımına erişim reddedildi hatasıyla karşılaşmadan veya kimlik bilgilerini temsilci olarak atamak için CredSSP kimlik doğrulamasını kullanmadan erişebilirsiniz.
User01 veya Domain01\User01gibi bir kullanıcı adı yazın veya cmdlet'i tarafından oluşturulan Get-Credential nesnesi girin. Bir kullanıcı adı yazarsanız parolayı girmeniz istenir.
Kimlik bilgileri bir PSCredential nesnesinde depolanır ve parola SecureStringolarak depolanır.
Uyarı
SecureString veri koruması hakkında daha fazla bilgi için bkz. SecureString ne kadar güvenli?.
Parametre özellikleri
| Tür: | PSCredential |
| Default value: | Current user |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-Force
Bu cmdlet'in günde bir kez sınırlamaya uymadığını, sürüm denetimini atladığını ve 1 GB sınırını aşan dosyaları indirdiğini gösterir.
Bu parametre olmadan, Update-Help her 24 saatlik dönemde yalnızca bir kez çalışır. İndirmeler modül başına 1 GB sıkıştırılmamış içerikle sınırlıdır ve yardım dosyaları yalnızca bilgisayardaki mevcut dosyalardan daha yeni olduklarında yüklenir.
Günde bir kez sınırı, yardım dosyalarını barındıran sunucuları korur ve yinelenen bağlantıların veya indirmelerin kaynak maliyetine neden olmadan PowerShell profilinize bir Update-Help komutu eklemenizi pratik hale getirir.
Force parametresi olmadan birden çok ui kültüründeki bir modülün yardımını güncelleştirmek için, aşağıdakiler gibi tüm ui kültürlerini aynı komuta ekleyin:
Update-Help -Module PSScheduledJobs -UICulture en-US, fr-FR, pt-BR
Parametre özellikleri
| Tür: | SwitchParameter |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-FullyQualifiedModule
Değer bir modül adı, tam modül belirtimi veya modül dosyasının yolu olabilir.
Değer bir yol olduğunda, yol tam veya göreli olabilir. Göreli yol, using deyimini içeren betike göre çözümlenir.
Değer bir ad veya modül belirtimi olduğunda PowerShell, belirtilen modülü psmodulepath
Modül belirtimi, aşağıdaki anahtarlara sahip bir karma tablodur.
-
ModuleName- Gerekli Modül adını belirtir. -
GUID- İsteğe bağlı Modülün GUID değerini belirtir. - Ayrıca aşağıdaki üç anahtardan en az birini belirtmek için Gerekli
. -
ModuleVersion- Modülün kabul edilebilir en düşük sürümünü belirtir. -
MaximumVersion- Modülün kabul edilebilir en yüksek sürümünü belirtir. -
RequiredVersion- Modülün tam ve gerekli bir sürümünü belirtir. Bu, diğer Sürüm anahtarlarıyla kullanılamaz.
-
Modülü parametresiyle aynı komutta FullyQualifiedModule parametresini belirtemezsiniz.
Parametre özellikleri
| Tür: | |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | True |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-LiteralPath
Güncelleştirilmiş yardım dosyalarını İnternet'ten indirmek yerine klasörü belirtir. Yardım dosyalarını bir dizine indirmek için cmdlet'ini kullandıysanız bu parametreyi veya Save-Help kullanın.
Get-Item veya Get-ChildItem cmdlet'leri gibi bir dizin nesnesini Update-Helpiçin işlem hattı oluşturabilirsiniz.
SourcePathdeğerinden farklı olarak, LiteralPath değeri tam olarak yazıldığı gibi kullanılır. Hiçbir karakter joker karakter olarak yorumlanmamıştır. Yol kaçış karakterleri içeriyorsa, yolu tek tırnak işaretleriyle çevreleyin. Tek tırnak işaretleri, PowerShell'in hiçbir karakteri kaçış dizisi olarak yorumlamamasını sağlar.
Parametre özellikleri
| Tür: | String[] |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
| Diğer adlar: | PSPath, LP |
Parametre kümeleri
LiteralPath
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | True |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-Module
Belirtilen modüller için güncelleştirme yardımı. Virgülle ayrılmış bir listeye bir veya daha fazla modül adı veya ad deseni girin veya her satırda bir modül adı listeleyen bir dosya belirtin. Joker karakterlere izin verilir. modülleri Get-Module cmdlet'inden Update-Help cmdlet'ine işlem hattı oluşturabilirsiniz.
Belirttiğiniz modüllerin bilgisayarda yüklü olması gerekir, ancak geçerli oturuma aktarılması gerekmez. Oturumdaki herhangi bir modülü veya $Env:PSModulePath ortam değişkeninde listelenen bir konuma yüklenmiş olan herhangi bir modülü belirtebilirsiniz.
* değeri (tümü) bilgisayarda yüklü olan tüm modüller için yardımı güncelleştirmeye çalışır.
Güncelleştirilebilir Yardımı desteklemeyen modüller dahil edilir. Komut Güncelleştirilebilir Yardımı desteklemeyen modüllerle karşılaştığında bu değer hata oluşturabilir. Bunun yerine, Update-Help parametresiz çalıştırın.
cmdlet'in Update-Help parametresi bir modül dosyasının veya modül bildirim dosyasının tam yolunu kabul etmez.
$Env:PSModulePath bir konumda olmayan bir modülün yardımını güncelleştirmek için, Update-Help komutunu çalıştırmadan önce modülü geçerli oturuma aktarın.
Parametre özellikleri
| Tür: | String[] |
| Default value: | None |
| Joker karakterleri destekler: | True |
| DontShow: | False |
| Diğer adlar: | İsim |
Parametre kümeleri
(All)
| Position: | 0 |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | True |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-Recurse
Belirtilen dizindeki yardım dosyaları için özyinelemeli bir arama gerçekleştirir. Bu parametre yalnızca komut SourcePath parametresini kullandığında geçerlidir.
Parametre özellikleri
| Tür: | SwitchParameter |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-Scope
Yardımın güncelleştirildiği sistem kapsamını belirtir.
AllUsers kapsamındaki güncelleştirmeler, Windows sistemlerinde yönetici ayrıcalıkları gerektirir.
-Scope parametresi PowerShell Core sürüm 6.1'de kullanıma sunulmuştur.
CurrentUser, PowerShell 6.1 ve üzeri yardım dosyaları için varsayılan kapsamdır.
AllUsers, tüm kullanıcılara yönelik yardımı yüklemek veya güncelleştirmek için belirtilebilir. Unix sistemlerinde tüm kullanıcılara yönelik yardımı güncelleştirmek için sudo ayrıcalıkları gerekir. Örneğin: sudo pwsh -c Update-Help
Kabul edilebilir değerler şunlardır:
- MevcutKullanıcı
- Tüm Kullanıcılar
Parametre özellikleri
| Tür: | UpdateHelpScope |
| Default value: | CurrentUser |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | True |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-SourcePath
Update-Help güncelleştirilmiş yardım dosyalarını internetten indirmek yerine aldığı bir dosya sistemi klasörü belirtir. Klasörün yolunu girin. Dosya adı veya dosya adı uzantısı belirtmeyin.
Get-Item veya Get-ChildItem cmdlet'leri gibi bir klasörü Update-Helpiçin işlem hattı oluşturabilirsiniz.
varsayılan olarak, Update-Help güncelleştirilmiş yardım dosyalarını İnternet'ten indirir. Güncelleştirilmiş yardım dosyalarını bir dizine indirmek için cmdlet'ini kullandığınızda Save-Help kullanın.
SourcePathiçin varsayılan bir değer belirtmek için, Grup İlkesi, Bilgisayar Yapılandırması'ne gidin ve Update-Helpiçin varsayılan kaynak yolunu ayarlayın. Bu Grup İlkesi ayarı, kullanıcıların yardım dosyalarını İnternet'ten indirmek için Update-Help kullanmasını engeller.
Daha fazla bilgi için bkz. about_Group_Policy_Settings.
Parametre özellikleri
| Tür: | String[] |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
| Diğer adlar: | Yol |
Parametre kümeleri
Path
| Position: | 1 |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-UICulture
Bu cmdlet'in güncelleştirilmiş yardım dosyalarını aldığı kullanıcı arabirimi kültürü değerlerini belirtir.
es-ESgibi bir veya daha fazla dil kodu, kültür nesneleri içeren bir değişken veya Get-Culture veya Get-UICulture komutu gibi kültür nesnelerini alan bir komut girin. Joker karakterlere izin verilmez.
varsayılan olarak, Update-Help işletim sistemi veya geri dönüş kültürü için ayarlanan kullanıcı arabirimi kültüründeki yardım dosyalarını alır.
UICulture parametresini belirtirseniz Update-Help yalnızca belirtilen dil için yardım arar.
PowerShell 7.4'te başlayarak, herhangi bir bölge için İngilizce yardım indirmek için en gibi kısmi bir dil kodu kullanabilirsiniz.
Uyarı
Ubuntu 18.04, varsayılan yerel ayarı C.UTF.8olarak değiştirmiştir. Bu, tanınan bir kullanıcı arabirimi kültürü değildir.
Update-Help, bu parametreyi en-USgibi desteklenen bir yerel ayar ile kullanmadığınız sürece sessizce indirme yardımı başarısız olur. Bu, desteklenmeyen bir değer kullanan herhangi bir platformda oluşabilir.
Parametre özellikleri
| Tür: | |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | 2 |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-UseDefaultCredentials
Update-Help geçerli kullanıcının kimlik bilgilerini kullanarak internet indirmesi de dahil olmak üzere komutunu çalıştırdığını gösterir. Varsayılan olarak, komut açık kimlik bilgileri olmadan çalışır.
Bu parametre yalnızca web indirmesi NT LAN Manager (NTLM), anlaşma veya Kerberos tabanlı kimlik doğrulaması kullandığında geçerlidir.
Parametre özellikleri
| Tür: | SwitchParameter |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-WhatIf
Cmdlet çalıştırılırsa ne olacağını gösterir. Cmdlet çalıştırılmıyor.
Parametre özellikleri
| Tür: | SwitchParameter |
| Default value: | False |
| Joker karakterleri destekler: | False |
| DontShow: | False |
| Diğer adlar: | Wi |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
CommonParameters
Bu cmdlet yaygın parametreleri destekler: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction ve -WarningVariable. Daha fazla bilgi için bkz. about_CommonParameters.
Girişler
DirectoryInfo
Dizin yolu nesnesini bu cmdlet'e yöneltebilirsiniz.
PSModuleInfo
Bir modül nesnesini bu cmdlet'e aktarabilirsiniz.
Çıkışlar
None
Bu cmdlet çıkış döndürmez.
Notlar
PowerShell ile yüklenen komutları veya $PSHOME\Modules dizinindeki herhangi bir modülü içeren temel PowerShell modüllerine yönelik yardımı güncelleştirmek için PowerShell'i yönetici olarak çalıştır seçeneğiyle başlatın.
Çekirdek PowerShell modülleri, PowerShell ile birlikte yüklenen komutlar ve $PSHOME\Modules klasöründeki modüller için yalnızca bilgisayardaki Yöneticiler grubunun üyeleri yardımı güncelleştirebilir. Yardım dosyalarını güncelleştirme izniniz yoksa yardım dosyalarını çevrimiçi olarak okuyabilirsiniz. Örneğin, Get-Help Update-Help -Online.
Modüller, güncelleştirilebilir yardımın en küçük birimidir. Belirli bir cmdlet için yardımı güncelleştiremezsiniz. Belirli bir cmdlet içeren modülü bulmak için, cmdlet'in Get-Command özelliğini kullanın, örneğin, (Get-Command Update-Help).ModuleName.
Yardım dosyaları modül dizinine yüklendiğinden, Update-Help cmdlet'i yalnızca bilgisayarda yüklü olan modüller için güncelleştirilmiş yardım dosyasını yükleyebilir. Ancak, Save-Help cmdlet'i bilgisayarda yüklü olmayan modüller için yardım kaydedebilir.
Update-Help cmdlet'i Windows PowerShell 3.0'da kullanıma sunulmuştur. PowerShell'in önceki sürümlerinde çalışmaz. Hem Windows PowerShell 2.0 hem de Windows PowerShell 3.0 bulunan bilgisayarlarda, yardım dosyalarını indirmek ve güncelleştirmek için Windows PowerShell 3.0 oturumunda Update-Help cmdlet'ini kullanın. Yardım dosyaları hem Windows PowerShell 2.0 hem de Windows PowerShell 3.0 tarafından kullanılabilir.
Update-Help ve Save-Help cmdlet'leri, yardım dosyalarını indirmek için aşağıdaki bağlantı noktalarını kullanır: HTTP için 80 numaralı bağlantı noktası ve HTTPS için 443 numaralı bağlantı noktası.
Update-Help tüm modülleri ve temel PowerShell ek bileşenlerini destekler. Diğer ek bileşenleri desteklemez.
$Env:PSModulePath ortam değişkeninde listelenmeyen bir konumdaki modülün yardımını güncelleştirmek için modülü geçerli oturuma aktarın ve ardından bir Update-Help komutu çalıştırın.
Update-Help parametresiz çalıştırın veya modül adını belirtmek için Module parametresini kullanın.
ve Update-Help cmdlet'lerinin Save-Help parametresi, modül dosyasının veya modül bildirim dosyasının tam yolunu kabul etmez.
Herhangi bir modül Güncelleştirilebilir Yardımı destekleyebilir. Oluşturduğunuz modüllerde Güncelleştirilebilir Yardım'ı destekleme yönergeleri için bkz. Güncelleştirilebilir Yardım'ı Destekleme.
Update-Help ve Save-Help cmdlet'leri Windows Önyükleme Ortamı'nda (Windows PE) desteklenmez.
