Aracılığıyla paylaş


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 Authordeğiştirir.

Update-PSModuleManifest -Path 'C:\MyModules\TestModule' -Author 'New Author'

Örnek 2

Bu örnek , Prerelease özelliğini olarak beta2değ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

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.Namedepolanı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.2gibi 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 previewModuleVersion ise 1.0.0modü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

Object

Notlar

Modül bildirim dosyasının tam açıklaması için bkz. about_Module_Manifests.