Update-Help

Başvuru

Modül:: Microsoft.PowerShell.Core

Bilgisayarınıza en yeni yardım dosyalarını indirir ve yükler.

Sözdizimi

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

Cmdlet, Update-Help PowerShell modülleri için en yeni yardım dosyalarını indirir ve bunları 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 cmdlet'ini kullanabilirsiniz Get-Help .

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 içinde bulunan $env:PSModulePathbir 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. Bir modül için güncelleştirilmiş yardım dosyaları bulunamazsa Update-Help , hata iletisi görüntülenmeden sessizce devam eder. Sürüm denetimini atlamak için Force 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 Module parametresini kullanın.

İşletim sisteminizin kültürel ayarları güncelleştirilebilir yardım için kullanılamayan bir dil için yapılandırılmışsa, Update-Help herhangi bir yardım indirmeden sessizce devam eder. Desteklenen bir dilde yardım dosyalarını indirmek için UICulture parametresini kullanın. Yerel ayar için en-US yardım her zaman kullanılabilir.

İnternet'e bağlı olmayan bilgisayarlarda da kullanabilirsiniz Update-Help . İlk olarak, cmdlet'ini Save-Helpkullanarak 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, paylaşılandan güncelleştirilmiş yardım dosyalarını indirmek ve bilgisayara yüklemek için sourcepath parametresini Update-Help kullanın.

Update-Help Cmdlet, Windows PowerShell 3.0'da kullanıma sunulmuştur.

Önemli

Update-Help yönetim ayrıcalıkları gerektirir.

Ç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 powershell.exe -Verb RunAs.

Windows PowerShell Tümleşik Betik Ortamı'ndaki (ISE) Yardım menüsündeki Windows PowerShell Yardımını Güncelleştir menü öğesini kullanarak da yardım dosyalarını güncelleştirebilirsiniz.

Windows PowerShell Yardım öğesini güncelleştir öğesi parametresiz bir Update-Help cmdlet çalıştırır. Dizindeki modüllerin yardımını $PSHOME güncelleştirmek için Yönetici olarak çalıştır seçeneğini kullanarak Windows PowerShell ISE'yi başlatın.

Örnekler

Örnek 1: Tüm modüller için yardım dosyalarını güncelleştirme

Update-Help Cmdlet, 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 yalnızca Microsoft.PowerShell ile başlayan modül adları için 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, birden çok dilde yardım indirmek için tasarlanmıştır. Ancak, sisteminizin kullandığı dil için kullanılabilir bir yardım olmadığında UICulture Update-Help parametresini kullanmadığınız sürece sessizce başarısız olur.

Bu örnekte, Update-Help yerel ayara ayarlanmış en-GB bir sistemde çalıştırılıyor.

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

Yardım dosyaları her zaman yerel ayar için en-US yayımlanır. İngilizce yardımını indirmek için UICulture parametresiyle komutunu çalıştırın Update-Help ve yerel ayarı belirtinen-US.

Örnek 4: Yardım dosyalarını otomatik olarak güncelleştirme

Bu örnek, her gün saat 03:00'te tüm modüller için yardımı güncelleştiren zamanlanmış bir iş oluşturur.

$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

cmdlet'i Register-ScheduledJob bir komut çalıştıran zamanlanmış bir Update-Help iş oluşturur. Komut, bilgisayardaki Administrators grubunun bir üyesinin kimlik bilgilerini kullanarak çalıştırmak Update-Help için Credential parametresini kullanır. Tetikleyici parametresinin değeri, New-JobTrigger işi her gün saat 03:00'te başlatan bir iş tetikleyicisi oluşturan bir komutdur.

Komutu çalıştırmak Register-ScheduledJob için Yönetici olarak çalıştır seçeneğini kullanarak PowerShell'i başlatın. PowerShell, Credential parametresinde belirtilen kullanıcının parolasını ister. Kimlik bilgileri zamanlanmış işle birlikte depolanır. İş çalıştırıldığında size sorulmaz.

Zamanlanmış işi görüntülemek için cmdlet'ini kullanabilir Get-ScheduledJob , Set-ScheduledJob değiştirmek için cmdlet'ini ve silmek için cmdlet'ini Unregister-ScheduledJob kullanabilirsiniz. Zamanlanmış işi Görev Zamanlayıcı'da aşağıdaki yolda görüntüleyebilir ve yönetebilirsiniz:

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

Örnek 5: 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
}

Komut, Save-Help Güncelleştirilebilir Yardım'ın desteklendiğini tüm modüller için en yeni yardım dosyalarını indirir. DestinationPath parametresi dosyaları dosya paylaşımına \\Server01\Share\PSHelp kaydeder. Credential parametresi, dosya paylaşımına erişim izni olan bir kullanıcıyı belirtir.

Invoke-Command Cmdlet, 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 komutunu çalıştırır Update-Help ve sourcepath parametresini kullanarak güncelleştirilmiş yardım dosyalarını içeren dosya paylaşımını belirtir. Credential parametresi, dosya paylaşımına erişebilen ve uzak Update-Help komutu çalıştırabilen bir kullanıcıyı belirtir.

Örnek 6: Güncelleştirilmiş yardım dosyalarının listesini alma

Belirtilen Update-Help modül için 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. Belirli bir modülün tüm yardım dosyalarının veya yardım dosyalarının çıkışını görüntülemek için Ayrıntılı'yi kullanabilirsiniz.

Ayrıntılı parametresi olmadan komutun Update-Help 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 7: Güncelleştirilebilir Yardım'ı destekleyen modülleri bulma

Bu örnekte Güncelleştirilebilir Yardımı destekleyen modüller listelenir. Komutu, Güncelleştirilebilir Yardım'ı destekleyen modülleri tanımlamak için modülün HelpInfoUri özelliğini kullanır. HelpInfoUri özelliği, cmdlet çalıştırıldığında Update-Help 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 8: Güncelleştirilmiş yardım dosyalarının envanteri

Bu örnekte betik Get-UpdateHelpVersion.ps1 , her modül ve sürüm numaraları için Güncelleştirilebilir Yardım dosyalarının bir 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.

Tür:	SwitchParameter
Diğer adlar:	cf
Position:	Named
Default value:	False
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

-Credential

SourcePath tarafı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.

Credential parametresi uzak bilgisayarlarda SourcePath parametresiyle komut çalıştırmanızı Update-Help 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\User01 gibi bir kullanıcı adı yazın veya cmdlet tarafından Get-Credential oluşturulan bir PSCredential nesnesi girin. Bir kullanıcı adı yazarsanız parolayı girmeniz istenir.

Kimlik bilgileri bir PSCredential nesnesinde depolanır ve parola SecureString olarak depolanır.

Not

SecureString veri koruması hakkında daha fazla bilgi için bkz. SecureString ne kadar güvenli?.

Tür:	PSCredential
Position:	Named
Default value:	Current user
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	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 komut Update-Help 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

Tür:	SwitchParameter
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	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 , PSModulePath'de belirtilen modülü arar.

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 gerekir .
- 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, gerekli bir sürümünü belirtir. Bu, diğer Sürüm anahtarlarıyla kullanılamaz.

Bir Module parametresiyle aynı komutta FullyQualifiedModule parametresini belirtemezsiniz.

Tür:	ModuleSpecification[]
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	True
Joker karakterleri kabul et:	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 Save-Help veya SourcePath'i kullanın.

veya Get-ChildItem cmdlet'leri Update-Helpgibi bir dizin nesnesini ile Get-Item işlem hattı oluşturabilirsiniz.

SourcePath değerinin aksine, 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, tek tırnak içine alın. Tek tırnak işaretleri PowerShell'e hiçbir karakteri kaçış dizisi olarak yorumlamaması gerektiğini söyler.

Tür:	String[]
Diğer adlar:	PSPath
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	True
Joker karakterleri kabul et:	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 cmdlet'inden Get-Module cmdlet'ine kadar işlem hattı oluşturabilirsiniz Update-Help .

Belirttiğiniz modüllerin bilgisayarda yüklü olması gerekir, ancak geçerli oturuma aktarılması gerekmez. Oturumdaki herhangi bir modülü veya ortam değişkeninde $env:PSModulePath listelenen bir konuma yüklenmiş olan herhangi bir modülü belirtebilirsiniz.

(tümü) değeri * , 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 parametresiz çalıştırın Update-Help .

cmdlet'in Update-Help Module parametresi bir modül dosyasının veya modül bildirim dosyasının tam yolunu kabul etmez. Bir konumda olmayan $env:PSModulePath modülün yardımını güncelleştirmek için, komutu çalıştırmadan önce modülü geçerli oturuma aktarın Update-Help .

Tür:	String[]
Diğer adlar:	Name
Position:	0
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	True
Joker karakterleri kabul et:	True

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

Tür:	SwitchParameter
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

-SourcePath

İnternet'ten indirmek yerine güncelleştirilmiş yardım dosyalarının alınacağı Update-Help bir dosya sistemi klasörü belirtir. Klasörün yolunu girin. Dosya adı veya dosya adı uzantısı belirtmeyin. veya Get-ChildItem cmdlet'lerinden Get-Item Update-Helpbiri gibi bir klasörü ile 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 Save-Help kullandığınızda SourcePath'i kullanın.

SourcePath için varsayılan bir değer belirtmek için Grup İlkesi, Bilgisayar Yapılandırması'na gidin ve Update-Help için varsayılan kaynak yolunu ayarlayın. Bu Grup İlkesi ayarı, kullanıcıların yardım dosyalarını internetten indirmek için kullanmasını Update-Help engeller. Daha fazla bilgi için, bkz. about_Group_Policy_Settings.

Tür:	String[]
Position:	1
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

-UICulture

Güncelleştirilmiş yardım dosyalarını almak için kullanılan kullanıcı arabirimi kültürü değerlerini Update-Help belirtir. es-ES gibi bir veya daha fazla dil kodu, kültür nesneleri içeren bir değişken veya veya Get-UICulture komutu gibi kültür nesnelerini alan bir Get-Culture komut girin. Joker karakterlere izin verilmez ve de gibi kısmi bir dil kodu gönderemezsiniz.

Varsayılan olarak, Update-Help işletim sistemi için ayarlanan kullanıcı arabirimi kültüründeki yardım dosyalarını alır. UICulture parametresini belirtirseniz, Update-Help yalnızca belirtilen ui kültürü için yardım arar.

UICulture parametresini kullanan komutlar yalnızca modül belirtilen UI kültürü için yardım dosyaları sağladığında başarılı olur. Belirtilen kullanıcı arabirimi kültürü desteklenmediği için komut başarısız olursa bir hata iletisi görüntülenir.

Tür:	CultureInfo[]
Position:	2
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

-UseDefaultCredentials

Geçerli kullanıcının kimlik bilgilerini kullanarak internet indirmesi de dahil olmak üzere komutunu çalıştırdığını Update-Help 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.

Tür:	SwitchParameter
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

-WhatIf

Cmdlet çalıştırılıyorsa ne olacağını gösterir. Cmdlet çalıştırılmıyor.

Tür:	SwitchParameter
Diğer adlar:	wi
Position:	Named
Default value:	False
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

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 dizindeki herhangi bir modülü içeren temel PowerShell modüllerine yönelik yardımı güncelleştirmek için PowerShell'i $PSHOME\Modules Yönetici olarak çalıştır seçeneğiyle başlatın.

Yalnızca bilgisayardaki Administrators grubunun üyeleri çekirdek PowerShell modülleri, PowerShell ile birlikte yüklenen komutlar ve klasördeki $PSHOME\Modules modüller için 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'inin ModuleName özelliğini kullanın; örneğin, (Get-Command Update-Help).ModuleName.Get-Command

Yardım dosyaları modül dizinine yüklendiğinden Update-Help , cmdlet yalnızca bilgisayarda yüklü olan modüller için güncelleştirilmiş yardım dosyasını yükleyebilir. Save-Help Ancak, cmdlet bilgisayarda yüklü olmayan modüller için yardım kaydedebilir.

Update-Help Cmdlet, 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 oturumundaki cmdlet'ini kullanın Update-Help . Yardım dosyaları hem Windows PowerShell 2.0 hem de Windows PowerShell 3.0 tarafından kullanılabilir.

ve Save-Help cmdlet'leriUpdate-Help, 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 çekirdek PowerShell ek bileşenlerini destekler. Diğer ek bileşenleri desteklemez.

Ortam değişkeninde listelenmeyen bir konumdaki modülün yardımını $env:PSModulePath güncelleştirmek için modülü geçerli oturuma aktarın ve ardından bir Update-Help komut çalıştırın. Parametre olmadan çalıştırın Update-Help veya modül adını belirtmek için Module parametresini kullanın. ve Save-Help cmdlet'lerinin Update-Help Module parametresi bir 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.

Aracılığıyla paylaş

Update-Help

Sözdizimi

Description

Örnekler

Örnek 1: Tüm modüller için yardım dosyalarını güncelleştirme

Örnek 2: Belirtilen modüller için yardım dosyalarını güncelleştirme

Örnek 3: En-US yerel ayarına ayarlı olmayan bir sistemde yardım güncelleştiriliyor

Örnek 4: Yardım dosyalarını otomatik olarak güncelleştirme

Örnek 5: Bir dosya paylaşımından birden çok bilgisayarda yardım dosyalarını güncelleştirme

Örnek 6: Güncelleştirilmiş yardım dosyalarının listesini alma

Örnek 7: Güncelleştirilebilir Yardım'ı destekleyen modülleri bulma

Örnek 8: Güncelleştirilmiş yardım dosyalarının envanteri

Parametreler

-Confirm

-Credential

-Force

-FullyQualifiedModule

-LiteralPath

-Module

-Recurse

-SourcePath

-UICulture

-UseDefaultCredentials

-WhatIf

Girişler

Çıkışlar

Notlar

Ek kaynaklar

Aracılığıyla paylaş

Update-Help

Sözdizimi

Description

Örnekler

Örnek 1: Tüm modüller için yardım dosyalarını güncelleştirme

Örnek 2: Belirtilen modüller için yardım dosyalarını güncelleştirme

Örnek 3: En-US yerel ayarına ayarlı olmayan bir sistemde yardım güncelleştiriliyor

Örnek 4: Yardım dosyalarını otomatik olarak güncelleştirme

Örnek 5: Bir dosya paylaşımından birden çok bilgisayarda yardım dosyalarını güncelleştirme

Örnek 6: Güncelleştirilmiş yardım dosyalarının listesini alma

Örnek 7: Güncelleştirilebilir Yardım'ı destekleyen modülleri bulma

Örnek 8: Güncelleştirilmiş yardım dosyalarının envanteri

Parametreler

-Confirm

-Credential

-Force

-FullyQualifiedModule

-LiteralPath

-Module

-Recurse

-SourcePath

-UICulture

-UseDefaultCredentials

-WhatIf

Girişler

Çıkışlar

Notlar

İlişkili Bağlantılar

Ek kaynaklar