Update-ModuleManifest

  • Başvuru
Modül:
PowerShellGet

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

Syntax

Update-ModuleManifest
      [-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[]>]
      [-PrivateData <Hashtable>]
      [-Tags <String[]>]
      [-ProjectUri <Uri>]
      [-LicenseUri <Uri>]
      [-IconUri <Uri>]
      [-ReleaseNotes <String[]>]
      [-Prerelease <String>]
      [-HelpInfoUri <Uri>]
      [-PassThru]
      [-DefaultCommandPrefix <String>]
      [-ExternalModuleDependencies <String[]>]
      [-PackageManagementProviders <String[]>]
      [-RequireLicenseAcceptance]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

cmdlet'i Update-ModuleManifest bir modül bildirimi (.psd1) dosyasını güncelleştirir.

Bu, Microsoft.PowerShell.PSResourceGet içindeki cmdlet için Update-PSModuleManifest bir proxy cmdlet'idir. Daha fazla bilgi için bkz . Update-PSModuleManifest.

Örnekler

Örnek 1: Modül bildirimini güncelleştirme

Bu örnek, mevcut bir modül bildirim dosyasını güncelleştirir. Splatting, parametre değerlerini öğesine geçirmek için Update-ModuleManifestkullanılır. Daha fazla bilgi için bkz. about_Splatting.

$Params = @{
  Path = "C:\Test\TestManifest.psd1"
  Author = "TestUser1"
  CompanyName = "Contoso Corporation"
  Copyright = "(c) 2019 Contoso Corporation. All rights reserved."
}

Update-ModuleManifest @Params

$ParamsPath, Author, CompanyName ve Copyright için parametre değerlerini depolayan bir platformdur. Update-ModuleManifest parametre değerlerini @Params alır ve TestManifest.psd1 modül bildirimini güncelleştirir.

Parametreler

-AliasesToExport

Modülün dışarı aktardığını diğer adları belirtir. Joker karakterlere izin verilir.

Modül tarafından dışarı aktarılan diğer adları kısıtlamak için bu parametreyi kullanın. AliasesToExport dışarı aktarılan diğer adlar listesinden diğer adları kaldırabilir, ancak listeye diğer ad ekleyemez.

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.

Not

Bu ayar yalnızca Windows PowerShell 5.1 gibi PowerShell Desktop sürümü için geçerlidir ve yalnızca 4.5'ten düşük .NET Framework sürümler için geçerlidir. Bu gereksinimin PowerShell'in veya .NET Framework daha yeni sürümleri için hiçbir etkisi yoktur.

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.

Modül tarafından dışarı aktarılan cmdlet'leri kısıtlamak için bu parametreyi kullanın. CmdletsToExport , dışarı aktarılan cmdlet'ler listesinden cmdlet'leri kaldırabilir, ancak cmdlet'leri listeye ekleyemez.

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ümlerine sahip modüller.

Type:String[]
Accepted values:Desktop, Core
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

çalıştırmadan Update-ModuleManifestönce sizden onay ister.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
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 en düşük Microsoft .NET Framework sürümünü belirtir.

Not

Bu ayar yalnızca Windows PowerShell 5.1 gibi PowerShell Desktop sürümü için geçerlidir ve yalnızca 4.5'ten düşük .NET Framework sürümler için geçerlidir. Bu gereksinimin PowerShell'in veya .NET Framework daha yeni sürümleri için hiçbir etkisi yoktur.

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:False

-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 çalıştırılan 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.

Modül tarafından dışarı aktarılan işlevleri kısıtlamak için bu parametreyi kullanın. FunctionsToExport dışarı aktarılan diğer adlar listesinden işlevleri kaldırabilir, ancak listeye işlev ekleyemez.

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üller arasında ayrım yapmak için kullanılabilir.

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. http veya https ile başlayan bir Tekdüzen Kaynak Tanımlayıcısı (URI) girin.

HelpInfo XML dosyası, PowerShell sürüm 3.0'da tanıtılan Güncelleştirilebilir Yardım özelliğini destekler. Modülün indirilebilir yardım dosyalarının konumu ve desteklenen her yerel ayar için en yeni yardım dosyalarının sürüm numaraları hakkında bilgi içerir.

Güncelleştirilebilir Yardım hakkında bilgi için bkz. about_Updatable_Help. HelpInfo XML dosyası hakkında bilgi için bkz. Güncelleştirilebilir Yardımı Destekleme.

Type:Uri
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-IconUri

Modül için bir simgenin URL'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ı 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ı birleştirebilirsiniz.

Bu anahtar, modül envanteri olarak görev yapmak üzere tasarlanmıştır. Bu anahtarın değerinde listelenen modüller otomatik olarak işlenmez.

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, değerde listelendikleri sırayla çalışır.

Modül adlarını 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ı birleştirebilirsiniz.

Type:Object[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PackageManagementProviders

Paket yönetimi sağlayıcıları dizisi belirtir.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PassThru

Üzerinde çalıştığınız öğeyi temsil eden bir nesne döndürür. Varsayılan olarak, Update-ModuleManifest herhangi bir çıkış oluşturmaz.

Type:SwitchParameter
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. Gibi $PSHOME\Modules\MyModule\MyModule.psd1bir dosya adı uzantısına sahip bir .psd1 yol ve dosya adı girin.

Varolan bir dosyanın yolunu belirtirseniz, Update-ModuleManifest dosya salt okunur özniteliğine sahip olmadığı sürece uyarı vermeden dosyanın yerini alır.

Bildirim modülün dizininde bulunmalı ve bildirim dosyası adı modül dizini adıyla aynı olmalı ancak bir .psd1 uzantıya sahip olmalıdır.

Yol parametre değeri istemine yanıt olarak veya $HOMEgibi $PSHOME değişkenleri kullanamazsınız. Değişken kullanmak için komutuna Path parametresini ekleyin.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
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ını bulmak için, programda yazın $Host.Name.

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ışacak en düşük PowerShell sürümünü belirtir. Örneğin, bu parametrenin değeri olarak 3.0, 4.0 veya 5.0 belirtebilirsiniz.

Type:Version
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Prerelease

Modülün yayın öncesi olduğunu gösterir.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PrivateData

Modül içeri aktarıldığında modüle geçirilen verileri belirtir.

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
  • Kol
  • IA64
  • MSIL
  • Hiçbiri (bilinmiyor veya belirtilmemiş)
  • X86
Type:ProcessorArchitecture
Accepted values:None, MSIL, X86, IA64, Amd64, Arm
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ProjectUri

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

Type:Uri
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ReleaseNotes

Betiğin bu sürümü için kullanılabilir olmasını istediğiniz sürüm notlarını veya açıklamaları içeren bir dize dizisi 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. Derleme dosyası adlarını girin. PowerShell türleri veya biçimleri güncelleştirmeden, iç içe modülleri içeri aktarmadan veya RootModule anahtarının değerinde 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 de dahil olmak üzere modülün gerektirdiği tüm derlemeleri belirtmek için bu parametreyi kullanın. Bu derlemeler NestedModules anahtarında ikili modüller olarak da listeleniyor 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.

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:None
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), cmdlet tanım XML dosyasının (.dll.cdxml veya iş akışının).xaml dosya adını girin. Modül içeri aktarıldığında, kök modül dosyasından dışarı aktarılan üyeler çağıranın oturum durumuna aktarılır.

Bir modülün bildirim dosyası varsa ve RootModule anahtarında kök dosya belirtilmemişse, bildirim modülün birincil dosyası olur. Modül bir bildirim modülüne (ModuleType = Manifest) dönüşür.

Bildirimi olan bir modüldeki .psm1 veya .dll modüldeki dosyaları dışarı aktarmak için, bu dosyaların adları bildirimdeki RootModule veya NestedModules anahtarlarının değerlerinde belirtilmelidir. Aksi takdirde, üyeleri dışarı aktarılamaz.

PowerShell 2.0'da bu anahtar ModuleToProcess olarak adlandırılıyordu.

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[]
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. VariablesToExport , dışarı aktarılan değişkenler listesinden değişkenleri kaldırabilir, ancak listeye değişken ekleyemez.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:True

-WhatIf

Çalıştırılırsa Update-ModuleManifest ne olacağını gösterir. Cmdlet çalıştırılmıyor.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Girişler

String

Çıkışlar

Object