Update-PSModuleManifest

  • Başvuru
Modül:
Microsoft.PowerShell.PSResourceGet

Modül bildirim dosyasını Güncelleştirmeler.

Sözdizimi

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.

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

-Author

Modül yazarını belirtir.

Tür:String
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et: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.

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

-CmdletsToExport

Modülün dışarı aktarıldığı cmdlet'leri belirtir. Joker karakterlere izin verilir.

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

-CompanyName

Modülü oluşturan şirketi veya satıcıyı belirtir.

Tür:String
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et: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.

Tür:String[]
Kabul edilen değerler:Desktop, Core
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-Copyright

Modül için bir telif hakkı bildirimi belirtir.

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

-DefaultCommandPrefix

Varsayılan komut ön ekini belirtir.

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

-Description

Modülün açıklamasını belirtir.

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

-DotNetFrameworkVersion

Modülün gerektirdiği Microsoft .NET Framework en düşük sürümünü belirtir.

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

-DscResourcesToExport

Modülün dışarı aktardığını Desired State Configuration (DSC) kaynaklarını belirtir. Joker karakterlere izin verilir.

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

-ExternalModuleDependencies

Dış modül bağımlılıkları dizisini belirtir.

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

-FileList

Modüle dahil edilen tüm öğeleri belirtir.

Tür:String[]
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et: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.

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

-FunctionsToExport

Modülün dışarı aktardığını işlevleri belirtir. Joker karakterlere izin verilir.

Tür:String[]
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et: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.

Tür:Guid
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et: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.

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

-IconUri

Modül için bir simgenin URI'sini belirtir. Belirtilen simge, modülün galeri web sayfasında görüntülenir.

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

-LicenseUri

Modülün lisans koşullarının URL'sini belirtir.

Tür:Uri
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et: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.

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

-ModuleVersion

Modülün sürümünü belirtir.

Tür:Version
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et: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.

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

-Path

Modül bildiriminin yolunu ve dosya adını belirtir. Dosya uzantısıyla .psd1 dosya adı girin.

Tür:String
Position:0
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et: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.

Tür:String
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et: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.

Tür:Version
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et: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.

Tür:Version
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et: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.

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

-PrivateData

İçeri aktarıldığında modüle geçirilen verileri belirtir. Bu, karma tablo içinde depolanan herhangi bir rastgele değer olabilir.

Tür:Hashtable
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et: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
Tür:ProcessorArchitecture
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-ProjectUri

Bu projeyle ilgili bir web sayfasının URI'sini belirtir.

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

-ReleaseNotes

Modül için sürüm notları veya açıklamalar içeren bir dize belirtir.

Tür:String
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et: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.

Tür:String[]
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et: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.
Tür:Object[]
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-RequireLicenseAcceptance

Modül için lisans kabulü gerektiğini belirtir.

Tür:SwitchParameter
Position:Named
Default value:False
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et: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.

Tür:String
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et: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.

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

-Tags

Bir etiket dizisi belirtir.

Tür:String[]
Diğer adlar:Tag
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et: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.

Tür:String[]
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et: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.

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

Girişler

None

Çıkışlar

Object

Notlar

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