Save-Help
En yeni yardım dosyalarını indirir ve bir dosya sistemi dizinine kaydeder.
Syntax
Path (Varsayılan)
Save-Help
[-DestinationPath] <String[]>
[[-Module] <PSModuleInfo[]>]
[[-UICulture] <CultureInfo[]>]
[-FullyQualifiedModule <ModuleSpecification[]>]
[-Credential <PSCredential>]
[-UseDefaultCredentials]
[-Force]
[-Scope <UpdateHelpScope>]
[<CommonParameters>]
LiteralPath
Save-Help
[[-Module] <PSModuleInfo[]>]
[[-UICulture] <CultureInfo[]>]
-LiteralPath <String[]>
[-FullyQualifiedModule <ModuleSpecification[]>]
[-Credential <PSCredential>]
[-UseDefaultCredentials]
[-Force]
[-Scope <UpdateHelpScope>]
[<CommonParameters>]
Description
Save-Help cmdlet'i PowerShell modülleri için en yeni yardım dosyalarını indirir ve bunları belirttiğiniz bir dizine kaydeder. Bu özellik, İnternet erişimi olmayan bilgisayarlardaki yardım dosyalarını güncelleştirmenizi sağlar ve birden çok bilgisayarda yardım dosyalarını güncelleştirmenizi kolaylaştırır.
Windows PowerShell 3.0'da Save-Help yalnızca yerel bilgisayarda yüklü modüller için çalıştı. Uzak bir bilgisayardan modülü içeri aktarmak veya PowerShell uzaktan iletişimini kullanarak uzak bir bilgisayardan PSModuleInfo nesnesine başvuru almak mümkün olsa da, HelpInfoUri özelliği korunmadı ve Save-Help uzak modül Yardımı için çalışmadı.
Windows PowerShell 4.0'da HelpInfoUri özelliği, Save-Help uzak bilgisayarlarda yüklü modüller için çalışmasını sağlayan PowerShell uzaktan iletişiminde korunur.
PSModuleInfo nesnesini İnternet erişimi olmayan bir bilgisayarda Export-Clixml çalıştırarak, nesneyi İnternet erişimi olan bir bilgisayarda içeri aktararak ve ardından Save-Help nesnesinde çalıştırarak diske veya çıkarılabilir medyaya kaydetmek de mümkündür. Kaydedilen yardım, USB sürücüsü gibi çıkarılabilir depolama medyası kullanılarak uzak bilgisayara taşınabilir. Yardım, Update-Helpçalıştırılarak uzak bilgisayara yüklenebilir. Bu işlem, herhangi bir ağ erişimi olmayan bilgisayarlara yardım yüklemek için kullanılabilir.
Kaydedilen yardım dosyalarını yüklemek için Update-Help cmdlet'ini çalıştırın. Yardım dosyalarını kaydettiğiniz klasörü belirtmek için SourcePath parametresini ekleyin.
Parametreler olmadan, Save-Help komutu oturumdaki tüm modüller ve PSModulePath ortam değişkeninde listelenen bir konumda bilgisayara yüklenen modüller için en yeni yardımı indirir. Bu eylem, uyarı olmadan Güncelleştirilebilir Yardım'ın desteklenmediği modülleri atlar.
Save-Help cmdlet'i hedef klasördeki tüm yardım dosyalarının sürümünü denetler. Daha yeni yardım dosyaları varsa, bu cmdlet en yeni yardım dosyalarını İnternet'ten indirir ve sonra bunları klasöre kaydeder.
Save-Help cmdlet'i, Update-Help cmdlet'i gibi çalışır, ancak indirilen dolap (.cab) dosyalarını kaydeder, dolap dosyalarından yardım dosyalarını ayıklamak ve bilgisayara yüklemek yerine.
Her modül için kaydedilen yardım, bir yardım bilgisi (HelpInfo XML) dosyası ve her ui kültürü için yardım dosyaları için bir dolap (.cab) dosyasından oluşur. Dolap dosyasından yardım dosyalarını ayıklamanız gerekmez.
Update-Help cmdlet'i yardım dosyalarını ayıklar, XML'yi güvenlik için doğrular ve ardından yardım dosyalarını ve yardım bilgileri dosyasını modül klasörünün dile özgü bir alt klasörüne yükler.
Modüllerin yardım dosyalarını PowerShell yükleme klasörüne ($pshome\Modules) kaydetmek için, Yönetici olarak çalıştır seçeneğini kullanarak PowerShell'i başlatın. Bu modüllerin yardım dosyalarını indirmek için bilgisayardaki Administrators grubunun bir üyesi olmanız gerekir.
Bu cmdlet, Windows PowerShell 3.0'da kullanıma sunulmuştur.
Örnekler
Örnek 1: DhcpServer modülü için yardımı kaydetme
# Option 1: Run Invoke-Command to get the PSModuleInfo object for the remote DHCP Server module,
# save the PSModuleInfo object in the variable $m, and then run Save-Help.
$m = Invoke-Command -ComputerName RemoteServer -ScriptBlock { Get-Module -Name DhcpServer -ListAvailable }
Save-Help -Module $m -DestinationPath "C:\SavedHelp"
# Option 2: Open a PSSession--targeted at the remote computer that is running the DhcpServer
# module--to get the PSModuleInfo object for the remote module, and then run Save-Help.
$s = New-PSSession -ComputerName "RemoteServer"
$m = Get-Module -PSSession $s -Name "DhcpServer" -ListAvailable
Save-Help -Module $m -DestinationPath "C:\SavedHelp"
# Option 3: Open a CIM session--targeted at the remote computer that is running the DhcpServer
# module--to get the PSModuleInfo object for the remote module, and then run Save-Help.
$c = New-CimSession -ComputerName "RemoteServer"
$m = Get-Module -CimSession $c -Name "DhcpServer" -ListAvailable
Save-Help -Module $m -DestinationPath "C:\SavedHelp"
Bu örnekte, Save-Help modülünü veya dhcp sunucusu rolünü yerel bilgisayara yüklemeden İnternet'e bağlı bir istemci bilgisayardan DhcpServer modülüne yönelik yardımı kaydetmek için kullanmanın üç farklı yolu gösterilmektedir.
Örnek 2: DhcpServer modülü için yardım yükleme
# First, run Export-CliXml to export the PSModuleInfo object to a shared folder or to removable media.
$m = Get-Module -Name "DhcpServer" -ListAvailable
Export-CliXml -Path "E:\UsbFlashDrive\DhcpModule.xml" -InputObject $m
# Next, transport the removable media to a computer that has Internet access, and then import the
# PSModuleInfo object with Import-CliXml. Run Save-Help to save the Help for the imported DhcpServer
# module PSModuleInfo object.
$deserialized_m = Import-CliXml "E:\UsbFlashDrive\DhcpModule.xml"
Save-Help -Module $deserialized_m -DestinationPath "E:\UsbFlashDrive\SavedHelp"
# Finally, transport the removable media back to the computer that does not have network access, and
# then install the help by running Update-Help.
Update-Help -Module DhcpServer -SourcePath "E:\UsbFlashDrive\SavedHelp"
Bu örnekte, İnternet erişimi olmayan bir bilgisayara DhcpServer modülü için Örnek 1'de kaydettiğiniz yardımın nasıl yükleneceği gösterilmektedir.
Örnek 3: Tüm modüller için yardım kaydetme
Save-Help -DestinationPath "\\Server01\FileShare01"
Bu komut, yerel bilgisayarda Windows için ayarlanan kullanıcı arabirimi kültüründeki tüm modüller için en yeni yardım dosyalarını indirir. Yardım dosyalarını \\Server01\Fileshare01 klasörüne kaydeder.
Örnek 4: Bilgisayardaki modül için yardım kaydetme
Save-Help -Module ServerManager -DestinationPath "\\Server01\FileShare01" -Credential Domain01/Admin01
Bu komut, ServerManager modülü için en yeni yardım dosyalarını indirir ve sonra bunları \\Server01\Fileshare01 klasörüne kaydeder.
Bilgisayara bir modül yüklendiğinde, modül geçerli oturuma aktarılmasa bile modül adını Modülü parametresinin değeri olarak yazabilirsiniz.
komut, dosya paylaşımına yazma izni olan bir kullanıcının kimlik bilgilerini sağlamak için Kimlik Bilgisi parametresini kullanır.
Örnek 5: Farklı bir bilgisayardaki modül için yardım kaydetme
Invoke-Command -ComputerName Server02 {Get-Module -Name CustomSQL -ListAvailable} | Save-Help -DestinationPath \\Server01\FileShare01 -Credential Domain01\Admin01
Bu komutlar, CustomSQL modülü için en yeni yardım dosyalarını indirir ve \\Server01\Fileshare01 klasörüne kaydeder.
CustomSQL modülü bilgisayarda yüklü olmadığından, sıra, Server02 bilgisayarından CustomSQL modülü için modül nesnesini alan ve ardından modül nesnesini Invoke-Command cmdlet'ine aktaran bir Save-Help komutu içerir.
Bilgisayarda bir modül yüklü olmadığında, Save-Help en yeni yardım dosyalarının konumu hakkında bilgi içeren modül nesnesine ihtiyaç duyar.
Örnek 6: Birden çok dilde bir modül için yardım kaydetme
Save-Help -Module Microsoft.PowerShell* -UICulture de-DE, en-US, fr-FR, ja-JP -DestinationPath "D:\Help"
Bu komut, dört farklı kullanıcı arabirimi kültüründeki temel PowerShell modülleri için yardım kaydeder. Bu yerel ayarlar için dil paketlerinin bilgisayara yüklenmesi gerekmez.
Save-Help, farklı ui kültürlerindeki modüller için yardım dosyalarını yalnızca modül sahibi çevrilmiş dosyaları İnternet'te kullanılabilir hale getirdiğinde indirebilir.
Örnek 7: Yardımı her gün birden fazla kez kaydetme
Save-Help -Force -DestinationPath "\\Server3\AdminShare\Help"
Bu komut, bilgisayarda yüklü olan tüm modüller için yardım kaydeder. komutu, cmdlet'in her 24 saatlik süre içinde yardımı birden çok kez indirmesini engelleyen kuralı geçersiz kılmak için Save-Help parametresini belirtir.
Force parametresi de 1 GB kısıtlamasını geçersiz kılar ve sürüm denetimini atlatır. Bu nedenle, sürüm hedef klasördeki sürümden daha geç olmasa bile dosyaları indirebilirsiniz.
komut, yardım dosyalarını indirmek ve belirtilen klasöre kaydetmek için Save-Help cmdlet'ini kullanır.
her gün birden fazla komutu çalıştırmanız gerektiğinde Save-Help parametresi gereklidir.
Parametreler
-Credential
Kullanıcı kimlik bilgilerini belirtir. Bu cmdlet, DestinationPath parametresi tarafından belirtilen dosya sistemi konumuna erişim izni olan bir kullanıcının kimlik bilgilerini kullanarak komutunu çalıştırır. Bu parametre yalnızca DestinationPath veya LiteralPath parametresi komutunda kullanıldığında geçerlidir.
Bu parametre, uzak bilgisayarlarda Save-Help parametresini kullanan 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: | 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 |
-DestinationPath
Yardım dosyalarının kaydedildiği klasörün yolunu belirtir. Dosya adı veya dosya adı uzantısı belirtmeyin.
Parametre özellikleri
| Tür: | String[] |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
| Diğer adlar: | Yol |
Parametre kümeleri
Path
| Position: | 0 |
| Zorunlu: | True |
| İş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, her 24 saatlik süre içinde her modül için yalnızca bir Save-Help komutuna izin verilir, indirme işlemleri modül başına 1 GB sıkıştırılmamış içerikle sınırlıdır ve modüle ait yardım dosyaları yalnızca bilgisayardaki dosyalardan daha yeni olduklarında yüklenir.
Günde bir kez sınırı, yardım dosyalarını barındıran sunucuları korur ve PowerShell profilinize bir Save-Help komutu eklemenizi pratik hale getirir.
Force parametresi olmadan birden çok kullanıcı arabirimi kültüründeki bir modül için yardım kaydetmek için, tüm kullanıcı arabirimi kültürlerini aynı komuta ekleyin, örneğin: Save-Help -Module PSScheduledJobs -UICulture en-US, fr-FR, pt-BR
Parametre özellikleri
| Tür: | SwitchParameter |
| Default value: | False |
| 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. iki parametre birbirini dışlar.
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
Hedef klasörün yolunu belirtir. DestinationPath parametresinin değerinden farklı olarak, LiteralPath parametresinin 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: | True |
| İş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 |
-Module
Bu cmdlet'in yardım indirdiği modülleri belirtir. Virgülle ayrılmış bir listeye veya her satırda bir modül adı olan bir dosyaya bir veya daha fazla modül adı veya ad patter girin. Joker karakterlere izin verilir. Modül nesnelerini Get-Module cmdlet'inden Save-Help'e de aktarabilirsiniz.
Varsayılan olarak, Güncelleştirilebilir Yardım'ı destekleyen ve yerel bilgisayarda Save-Help ortam değişkeninde listelenen bir konumda yüklü olan tüm modüller için indirme yardımı.
Bilgisayarda yüklü olmayan modüller için yardım kaydetmek için uzak bilgisayarda bir Get-Module komutu çalıştırın. Ardından, elde edilen modül nesnelerini Save-Help cmdlet'ine aktarın veya modül nesnelerini Module veya InputObject parametrelerinin değeri olarak gönderin.
Belirttiğiniz modül bilgisayarda yüklüyse modül adını veya modül nesnesini girebilirsiniz. Modül bilgisayarda yüklü değilse, Get-Module cmdlet'i tarafından döndürülen bir modül nesnesi gibi bir modül nesnesi girmeniz gerekir.
cmdlet'in Save-Help parametresi, modül dosyasının veya modül bildirim dosyasının tam yolunu kabul etmez.
PSModulePath konumunda olmayan bir modülün yardımını kaydetmek için, Save-Help komutunu çalıştırmadan önce modülü geçerli oturuma aktarın.
"*" (tümü) değeri, bilgisayarda yüklü olan tüm modüller için yardımı güncelleştirmeye çalışır. Bu, Güncelleştirilebilir Yardım'ın desteklenmediği modülleri içerir. Komut Güncelleştirilebilir Yardım'ın desteklenmediği modüllerle karşılaştığında bu değer hata oluşturabilir.
Parametre özellikleri
| Tür: | |
| Default value: | None |
| Joker karakterleri destekler: | True |
| DontShow: | False |
| Diğer adlar: | İsim |
Parametre kümeleri
(All)
| Position: | 1 |
| Zorunlu: | False |
| İşlem hattından gelen değer: | True |
| Ö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 |
-Scope
Bu parametre bu cmdlet'te hiçbir şey yapmaz.
Parametre özellikleri
| Tür: | UpdateHelpScope |
| 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 |
-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. "de" gibi kısmi bir dil kodu belirtmeyin.
Varsayılan olarak, Save-Help Windows için ayarlanan kullanıcı arabirimi kültüründe veya geri dönüş kültüründe yardım dosyalarını alır.
UICulture parametresini belirtirseniz, Save-Help herhangi bir geri dönüş kültüründe değil, yalnızca belirtilen ui kültürü için yardım arar.
Parametre özellikleri
| Tür: | |
| Default value: | Current UI culture |
| 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
Bu cmdlet'in geçerli kullanıcının kimlik bilgileriyle web 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 NTLM, anlaşma veya Kerberos tabanlı kimlik doğrulaması kullandığında geçerlidir.
Parametre özellikleri
| Tür: | SwitchParameter |
| Default value: | False |
| 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 |
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
PSModuleInfo
Bir modül nesnesini bu cmdlet'e aktarabilirsiniz.
Çıkışlar
None
Bu cmdlet çıkış döndürmez.
Notlar
- modüllerin yardımını $pshome\Modules klasörüne kaydetmek için Yönetici olarak çalıştır seçeneğini kullanarak PowerShell'i başlatın. yalnızca bilgisayardaki Administrators grubunun üyeleri $pshome\Modules klasöründeki modüller için yardım indirebilir.
- Her modül için kaydedilen yardım, bir yardım bilgisi (HelpInfo XML) dosyası ve her ui kültürü için yardım dosyaları için bir dolap (.cab) dosyasından oluşur. Dolap dosyasından yardım dosyalarını ayıklamanız gerekmez.
Update-Helpcmdlet'i yardım dosyalarını ayıklar, XML'yi doğrular ve ardından yardım dosyalarını ve yardım bilgileri dosyasını modül klasörünün dile özgü alt klasörüne yükler. -
Save-Helpcmdlet'i, bilgisayarda yüklü olmayan modüller için yardım kaydedebilir. Ancak, yardım dosyaları modül klasörüne yüklendiğinden,Update-Helpcmdlet yalnızca bilgisayarda yüklü modüller için güncelleştirilmiş yardım dosyasını yükleyebilir. -
Save-Helpbir modül için güncelleştirilmiş yardım dosyalarını bulamazsa veya belirtilen dilde güncelleştirilmiş yardım dosyalarını bulamazsa, hata iletisi görüntülenmeden sessizce devam eder. Komutu tarafından hangi dosyaların kaydedildiğini görmek için Ayrıntılı parametresini belirtin. - Modüller, güncelleştirilebilir yardımın en küçük birimidir. Belirli bir cmdlet için, yalnızca modüldeki tüm cmdlet'ler için yardım kaydedemezsiniz. Belirli bir cmdlet içeren modülü bulmak için cmdlet'iyle birlikte
Get-Commandözelliğini kullanın, örneğin,(Get-Command \<cmdlet-name\>).ModuleName -
Save-Helptüm modülleri ve temel PowerShell ek bileşenlerini destekler. Diğer ek bileşenleri desteklemez. -
Update-HelpveSave-Helpcmdlet'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-HelpveSave-Helpcmdlet'leri Windows Önyükleme Ortamı'nda (Windows PE) desteklenmez.