Update-PSModuleManifest
Modül bildirim dosyasını Güncelleştirmeler.
Syntax
Update-PSModuleManifest
[-Path] <String>
[-NestedModules <Object[]>]
[-Guid <Guid>]
[-Author <String>]
[-CompanyName <String>]
[-Copyright <String>]
[-RootModule <String>]
[-ModuleVersion <Version>]
[-Description <String>]
[-ProcessorArchitecture <ProcessorArchitecture>]
[-CompatiblePSEditions <String[]>]
[-PowerShellVersion <Version>]
[-ClrVersion <Version>]
[-DotNetFrameworkVersion <Version>]
[-PowerShellHostName <String>]
[-PowerShellHostVersion <Version>]
[-RequiredModules <Object[]>]
[-TypesToProcess <String[]>]
[-FormatsToProcess <String[]>]
[-ScriptsToProcess <String[]>]
[-RequiredAssemblies <String[]>]
[-FileList <String[]>]
[-ModuleList <Object[]>]
[-FunctionsToExport <String[]>]
[-AliasesToExport <String[]>]
[-VariablesToExport <String[]>]
[-CmdletsToExport <String[]>]
[-DscResourcesToExport <String[]>]
[-Tags <String[]>]
[-ProjectUri <Uri>]
[-LicenseUri <Uri>]
[-IconUri <Uri>]
[-ReleaseNotes <String>]
[-Prerelease <String>]
[-HelpInfoUri <Uri>]
[-DefaultCommandPrefix <String>]
[-ExternalModuleDependencies <String[]>]
[-RequireLicenseAcceptance]
[-PrivateData <Hashtable>]
[<CommonParameters>]
Description
Bu cmdlet bir modül bildirim dosyasında depolanan verileri güncelleştirir. parametreler, hangi özelliklerin güncelleştirileceğini belirtmenize olanak sağlar. Update-PSModuleManifest
modül bildirimindeki mevcut değerlerin üzerine yazar.
Cmdlet bir nesne döndürmez.
Örnekler
Örnek 1
Bu örnek, modül bildirimindeki Author özelliğini olarak New Author
değiştirir.
Update-PSModuleManifest -Path 'C:\MyModules\TestModule' -Author 'New Author'
Örnek 2
Bu örnek , Prerelease özelliğini olarak beta2
değiştirir.
Update-PSModuleManifest -Path 'C:\MyModules\TestModule' -Prerelease 'beta2'
Örnek 3
Bu örnek birden çok özelliği güncelleştirir.
$parameters = @{
Path = 'C:\MyModules\TestModule'
Tags = 'Windows', 'Linux'
Description = 'A module for managing packages.'
}
Update-PSModuleManifest
Parametreler
-AliasesToExport
Modülün dışarı aktardığını diğer adları belirtir. Joker karakterlere izin verilir.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-Author
Modül yazarını belirtir.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ClrVersion
Modülün gerektirdiği Microsoft .NET Framework Ortak Dil Çalışma Zamanı'nın (CLR) en düşük sürümünü belirtir.
Type: | Version |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CmdletsToExport
Modülün dışarı aktarıldığı cmdlet'leri belirtir. Joker karakterlere izin verilir.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-CompanyName
Modülü oluşturan şirketi veya satıcıyı belirtir.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CompatiblePSEditions
Modülün uyumlu PSEdition'larını belirtir. PSEdition hakkında bilgi için bkz. Uyumlu PowerShell Sürümleri ile modüller.
Type: | String[] |
Accepted values: | Desktop, Core |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Copyright
Modül için bir telif hakkı bildirimi belirtir.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DefaultCommandPrefix
Varsayılan komut ön ekini belirtir.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Description
Modülün açıklamasını belirtir.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DotNetFrameworkVersion
Modülün gerektirdiği Microsoft .NET Framework en düşük sürümünü belirtir.
Type: | Version |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DscResourcesToExport
Modülün dışarı aktardığını Desired State Configuration (DSC) kaynaklarını belirtir. Joker karakterlere izin verilir.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-ExternalModuleDependencies
Dış modül bağımlılıkları dizisini belirtir.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-FileList
Modüle dahil edilen tüm öğeleri belirtir.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-FormatsToProcess
Modül içeri aktarıldığında işlenen biçimlendirme dosyalarını (.ps1xml
) belirtir.
Bir modülü içeri aktardığınızda, PowerShell cmdlet'ini Update-FormatData
belirtilen dosyalarla çalıştırır.
Biçimlendirme dosyalarının kapsamı olmadığından, bunlar oturumdaki tüm oturum durumlarını etkiler.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-FunctionsToExport
Modülün dışarı aktardığını işlevleri belirtir. Joker karakterlere izin verilir.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-Guid
Modül için benzersiz bir tanımlayıcı belirtir. GUID, aynı ada sahip modülleri ayırt etmek için kullanılır.
Type: | Guid |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-HelpInfoUri
Modülün HelpInfo XML dosyasının internet adresini belirtir. veya https:
ile http:
başlayan bir Tekdüzen Kaynak Tanımlayıcısı (URI) girin.
Daha fazla bilgi için Güncelleştirilebilir Yardım'a bakın.
Type: | Uri |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-IconUri
Modül için bir simgenin URI'sini belirtir. Belirtilen simge, modülün galeri web sayfasında görüntülenir.
Type: | Uri |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-LicenseUri
Modülün lisans koşullarının URL'sini belirtir.
Type: | Uri |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ModuleList
Modüle dahil edilen modül dizisini belirtir.
Modül adlarını bir dize olarak veya ModuleName ve ModuleVersion anahtarlarıyla karma tablo olarak girin. Karma tablo isteğe bağlı bir GUID anahtarına da sahip olabilir. Parametre değerinde dizeleri ve karma tablolarını birleştirebilirsiniz.
Bu anahtar, modül envanteri olarak görev yapmak üzere tasarlanmıştır.
Type: | Object[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ModuleVersion
Modülün sürümünü belirtir.
Type: | Version |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-NestedModules
Modülün oturum durumuna aktarılan betik modüllerini (.psm1
) ve ikili modülleri (.dll
) belirtir. NestedModules anahtarındaki dosyalar listelendikleri sırayla çalışır.
Modül adlarını bir dize olarak veya ModuleName ve ModuleVersion anahtarlarıyla karma tablo olarak girin. Karma tablo isteğe bağlı bir GUID anahtarına da sahip olabilir. Parametre değerinde dizeleri ve karma tablolarını birleştirebilirsiniz.
Type: | Object[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Path
Modül bildiriminin yolunu ve dosya adını belirtir. Dosya uzantısıyla .psd1
dosya adı girin.
Type: | String |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PowerShellHostName
Modülün gerektirdiği PowerShell konak programının adını belirtir. PowerShell ISE Konağı veya ConsoleHost gibi konak programının adını girin. Joker karakterlere izin verilmez.
Bir konak programının adı içinde $Host.Name
depolanır.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PowerShellHostVersion
Modülle çalışan PowerShell konak programının en düşük sürümünü belirtir. 1.1 gibi bir sürüm numarası girin.
Type: | Version |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PowerShellVersion
Bu modülle çalışan en düşük PowerShell sürümünü belirtir. Örneğin, veya 7.2
gibi 5.1
sürümleri belirtebilirsiniz.
Type: | Version |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Prerelease
Modül sürümüne eklenen ön sürüm değerini belirtir. Örneğin , Prerelease ve preview
ModuleVersion ise 1.0.0
modülün sürümü olur 1.0.0-preview
.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PrivateData
İçeri aktarıldığında modüle geçirilen verileri belirtir. Bu, karma tablo içinde depolanan herhangi bir rastgele değer olabilir.
Type: | Hashtable |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ProcessorArchitecture
Modülün gerektirdiği işlemci mimarisini belirtir.
Bu parametrenin kabul edilebilir değerleri şunlardır:
Amd64
Arm
IA64
MSIL
None
(bilinmiyor veya belirtilmemiş)X86
Type: | ProcessorArchitecture |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ProjectUri
Bu projeyle ilgili bir web sayfasının URI'sini belirtir.
Type: | Uri |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ReleaseNotes
Modül için sürüm notları veya açıklamalar içeren bir dize belirtir.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RequiredAssemblies
Modülün gerektirdiği derleme (.dll
) dosyalarını belirtir. PowerShell türleri veya biçimleri güncelleştirmeden, iç içe modülleri içeri aktarmadan veya RootModule anahtarında belirtilen modül dosyasını içeri aktarmadan önce belirtilen derlemeleri yükler.
FormatsToProcess veya TypesToProcess anahtarlarında listelenen biçimlendirme veya tür dosyalarını güncelleştirmek için yüklenmesi gereken derlemeler için RequiredAssemblies kullanın. Bu derlemeler NestedModules anahtarında da listelenmiş olsa bile.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RequiredModules
Genel oturum durumunda olması gereken modülleri belirtir. Gerekli modüller genel oturum durumunda değilse PowerShell bunları içeri aktarır. Gerekli modüller kullanılamıyorsa Import-Module
komut başarısız olur.
Değer, modül adlarını veya modül belirtimlerini içeren bir dizi olabilir. Modül belirtimi, aşağıdaki anahtarlara sahip bir karma tablodur.
ModuleName
- Gerekli Modül adını belirtir.GUID
- Isteğ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.
Type: | Object[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RequireLicenseAcceptance
Modül için lisans kabulü gerektiğini belirtir.
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RootModule
Modülün birincil veya kök dosyasını belirtir. Bir betiğin (.ps1
), betik modülünün (.psm1
), modül bildiriminin (), derlemenin (.psd1
.dll
veya cmdlet tanımı XML dosyasının (.cdxml
) dosya adını girin. Modül içeri aktarıldığında kök modülden dışarı aktarılan üyeler çağıranın oturum durumuna aktarılır.
Bir modülün bildirim dosyası varsa ve RootModule anahtarında hiçbir dosya belirtilmezse, bildirim modülün birincil dosyası olur. Modül bildirim modülü (ModuleType =
Manifest
) olarak bilinir.
Veya .dll
dosyalarından .psm1
üyeleri dışarı aktarmak için, bu dosyaların adları bildirimdeki RootModule veya NestedModules anahtarlarının değerlerinde belirtilmelidir.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ScriptsToProcess
Modül içeri aktarıldığında çağıranın oturum durumunda çalıştırılan betik (.ps1
) dosyalarını belirtir.
Bu betikleri bir ortam hazırlamak için kullanabilirsiniz, aynı oturum açma betiği gibi.
Modülün oturum durumunda çalıştırılan betikleri belirtmek için NestedModules anahtarını kullanın.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Tags
Bir etiket dizisi belirtir.
Type: | String[] |
Aliases: | Tag |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TypesToProcess
Modül içeri aktarıldığında çalıştırılan tür dosyalarını (.ps1xml
) belirtir.
Modülü içeri aktardığınızda, PowerShell cmdlet'ini Update-TypeData
belirtilen dosyalarla çalıştırır.
Tür dosyalarının kapsamı olmadığından, bunlar oturumdaki tüm oturum durumlarını etkiler.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-VariablesToExport
Modülün dışarı aktardığını değişkenleri belirtir. Joker karakterlere izin verilir.
Modül tarafından dışarı aktarılan değişkenleri kısıtlamak için bu parametreyi kullanın.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | True |
Girişler
None
Çıkışlar
Notlar
Modül bildirim dosyasının tam açıklaması için bkz. about_Module_Manifests.
İlişkili Bağlantılar
PSResourceGet
Geri Bildirim
https://aka.ms/ContentUserFeedback.
Çok yakında: 2024 boyunca, içerik için geri bildirim mekanizması olarak GitHub Sorunları’nı kullanımdan kaldıracak ve yeni bir geri bildirim sistemiyle değiştireceğiz. Daha fazla bilgi için bkz.Gönderin ve geri bildirimi görüntüleyin