New-ModuleManifest

Yeni bir modül bildirimi oluşturur.

Sözdizimi

New-ModuleManifest
   [-Path] <String>
   [-NestedModules <Object[]>]
   [-Guid <Guid>]
   [-Author <String>]
   [-CompanyName <String>]
   [-Copyright <String>]
   [-RootModule <String>]
   [-ModuleVersion <Version>]
   [-Description <String>]
   [-ProcessorArchitecture <ProcessorArchitecture>]
   [-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[]>]
   [-CompatiblePSEditions <String[]>]
   [-PrivateData <Object>]
   [-Tags <String[]>]
   [-ProjectUri <Uri>]
   [-LicenseUri <Uri>]
   [-IconUri <Uri>]
   [-ReleaseNotes <String>]
   [-Prerelease <String>]
   [-RequireLicenseAcceptance]
   [-ExternalModuleDependencies <String[]>]
   [-HelpInfoUri <String>]
   [-PassThru]
   [-DefaultCommandPrefix <String>]
   [-WhatIf]
   [-Confirm] 
   [<CommonParameters>]

Description

New-ModuleManifest Cmdlet yeni bir modül bildirimi (.psd1) dosyası oluşturur, değerlerini doldurur ve bildirim dosyasını belirtilen yola kaydeder.

Modül yazarları bu cmdlet'i kullanarak modülleri için bir bildirim oluşturabilir. Modül bildirimi, karma tablo içeren bir dosyadır .psd1 . Karma tablodaki anahtarlar ve değerler modülün içeriğini ve özniteliklerini açıklar, önkoşulları tanımlar ve bileşenlerin nasıl işlendiğini belirler. Bir modül için bildirimler gerekli değildir.

New-ModuleManifest , varsayılan çıkışı bildirim şablonu olarak kullanabilmeniz için yaygın olarak kullanılan tüm bildirim anahtarlarını içeren bir bildirim oluşturur. Değerleri eklemek veya değiştirmek ya da bu cmdlet'in eklemediği modül anahtarlarını eklemek için, sonuçta elde edilen dosyayı bir metin düzenleyicisinde açın.

Path ve PassThru dışında her parametre bir modül bildirim anahtarı ve değeri oluşturur. Modül bildiriminde yalnızca ModuleVersion anahtarı gereklidir. Parametre açıklamasında belirtilmediği sürece, komutundan bir parametreyi atlarsanız, New-ModuleManifest ilişkili değer için hiçbir etkisi olmayan bir açıklama dizesi oluşturur.

PowerShell 2.0'da, New-ModuleManifest gerekli parametre değerlerine ek olarak komutta belirtilmeyen yaygın olarak kullanılan parametrelerin değerlerini ister. PowerShell 3.0'da başlayarak, New-ModuleManifest yalnızca gerekli parametre değerleri belirtilmediğinde istemler oluşturur.

Modülünüzü PowerShell Galerisi yayımlamayı planlıyorsanız bildirim belirli özellikler için değerler içermelidir. Daha fazla bilgi için Galeri belgelerindeki PowerShell Galerisi yayımlanan öğeler için gerekli meta veriler bölümüne bakın.

Örnekler

Örnek 1 - Yeni modül bildirimi oluşturma

Bu örnek, dosyada Path parametresi tarafından belirtilen yeni bir modül bildirimi oluşturur. PassThru parametresi çıkışı işlem hattına ve dosyasına gönderir.

Çıkış, bildirimdeki tüm anahtarların varsayılan değerlerini gösterir.

New-ModuleManifest -Path C:\ps-test\Test-Module\Test-Module.psd1 -PassThru

#
# Module manifest for module 'Test-Module'
#
# Generated by: ContosoAdmin
#
# Generated on: 7/12/2019
#

@{

# Script module or binary module file associated with this manifest.
# RootModule = ''

# Version number of this module.
ModuleVersion = '0.0.1'

# Supported PSEditions
# CompatiblePSEditions = @()

# ID used to uniquely identify this module
GUID = 'e1826c6e-c420-4eef-9ac8-185e3669ca6a'

# Author of this module
Author = 'ContosoAdmin'

# Company or vendor of this module
CompanyName = 'Unknown'

# Copyright statement for this module
Copyright = '(c) ContosoAdmin. All rights reserved.'

# Description of the functionality provided by this module
# Description = ''

# Minimum version of the PowerShell engine required by this module
# PowerShellVersion = ''

# Name of the PowerShell host required by this module
# PowerShellHostName = ''

# Minimum version of the PowerShell host required by this module
# PowerShellHostVersion = ''

# Minimum version of Microsoft .NET Framework required by this module. This prerequisite is valid for the PowerShell Desktop edition only.
# DotNetFrameworkVersion = ''

# Minimum version of the common language runtime (CLR) required by this module. This prerequisite is valid for the PowerShell Desktop edition only.
# CLRVersion = ''

# Processor architecture (None, X86, Amd64) required by this module
# ProcessorArchitecture = ''

# Modules that must be imported into the global environment prior to importing this module
# RequiredModules = @()

# Assemblies that must be loaded prior to importing this module
# RequiredAssemblies = @()

# Script files (.ps1) that are run in the caller's environment prior to importing this module.
# ScriptsToProcess = @()

# Type files (.ps1xml) to be loaded when importing this module
# TypesToProcess = @()

# Format files (.ps1xml) to be loaded when importing this module
# FormatsToProcess = @()

# Modules to import as nested modules of the module specified in RootModule/ModuleToProcess
# NestedModules = @()

# Functions to export from this module, for best performance, do not use wildcards and do not delete the entry, use an empty array if there are no functions to export.
FunctionsToExport = @()

# Cmdlets to export from this module, for best performance, do not use wildcards and do not delete the entry, use an empty array if there are no cmdlets to export.
CmdletsToExport = @()

# Variables to export from this module
VariablesToExport = '*'

# Aliases to export from this module, for best performance, do not use wildcards and do not delete the entry, use an empty array if there are no aliases to export.
AliasesToExport = @()

# DSC resources to export from this module
# DscResourcesToExport = @()

# List of all modules packaged with this module
# ModuleList = @()

# List of all files packaged with this module
# FileList = @()

# Private data to pass to the module specified in RootModule/ModuleToProcess. This may also contain a PSData hashtable with additional module metadata used by PowerShell.
PrivateData = @{

    PSData = @{

        # Tags applied to this module. These help with module discovery in online galleries.
        # Tags = @()

        # A URL to the license for this module.
        # LicenseUri = ''

        # A URL to the main website for this project.
        # ProjectUri = ''

        # A URL to an icon representing this module.
        # IconUri = ''

        # ReleaseNotes of this module
        # ReleaseNotes = ''

        # Prerelease string of this module
        # Prerelease = ''

        # Flag to indicate whether the module requires explicit user acceptance for install/update/save
        # RequireLicenseAcceptance = $false

        # External dependent modules of this module
        # ExternalModuleDependencies = @()

    } # End of PSData hashtable

} # End of PrivateData hashtable

# HelpInfo URI of this module
# HelpInfoURI = ''

# Default prefix for commands exported from this module. Override the default prefix using Import-Module -Prefix.
# DefaultCommandPrefix = ''

}

Örnek 2 - Önceden doldurulmuş bazı ayarlarla yeni bir bildirim oluşturma

Bu örnek yeni bir modül bildirimi oluşturur. İlgili bildirim anahtarlarına değer eklemek için PowerShellVersion ve AliasesToExport parametrelerini kullanır.

$moduleSettings = @{
    PowerShellVersion = 1.0
    Path   = 'C:\ps-test\ManifestTest.psd1'
    AliasesToExport   = @(
      'JKBC'
      'DRC'
      'TAC'
    )
}
New-ModuleManifest @moduleSettings

Örnek 3 - Diğer modülleri gerektiren bir bildirim oluşturma

Bu örnekte, BitsTransfer modülünün adını belirtmek için bir dize biçimi ve PSScheduledJob modülünün adını, GUID'sini ve sürümünü belirtmek için karma tablo biçimi kullanılır.

$moduleSettings = @{
  RequiredModules = ("BitsTransfer", @{
    ModuleName="PSScheduledJob"
    ModuleVersion="1.0.0.0";
    GUID="50cdb55f-5ab7-489f-9e94-4ec21ff51e59"
  })
  Path = 'C:\ps-test\ManifestTest.psd1'
}
New-ModuleManifest @moduleSettings

Bu örnekte ModuleList, RequiredModules ve NestedModules parametresinin dize ve karma tablo biçimlerinin nasıl kullanılacağı gösterilmektedir. Dizeleri ve karma tabloları aynı parametre değerinde birleştirebilirsiniz.

Örnek 4 - Güncelleştirilebilir yardımı destekleyen bir bildirim oluşturma

Bu örnek, modül bildiriminde bir HelpInfoUri anahtarı oluşturmak için HelpInfoUri parametresini kullanır. parametresinin ve anahtarın değeri http veya https ile başlamalıdır. Bu değer, Güncelleştirilebilir Yardım sistemine modülün HelpInfo XML güncelleştirilebilir yardım bilgileri dosyasını nerede bulacağını bildirir.

$moduleSettings = @{
  HelpInfoUri = 'http://https://go.microsoft.com/fwlink/?LinkID=603'
  Path = 'C:\ps-test\ManifestTest.psd1'
}
New-ModuleManifest @moduleSettings

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.

Örnek 5 - Modül bilgilerini alma

Bu örnekte bir modülün yapılandırma değerlerinin nasıl alınıyor olduğu gösterilmektedir. Modül bildirimindeki değerler, modül nesnesinin özelliklerinin değerlerine yansıtılır.

Get-Module Cmdlet, List parametresi kullanılarak Microsoft.PowerShell.Diagnostics modülünü almak için kullanılır. komutu, modül nesnesinin Format-List tüm özelliklerini ve değerlerini görüntülemek için modülü cmdlet'ine gönderir.

Get-Module Microsoft.PowerShell.Diagnostics -List | Format-List -Property *

LogPipelineExecutionDetails : False
Name                        : Microsoft.PowerShell.Diagnostics
Path                        : C:\Windows\system32\WindowsPowerShell\v1.0\Modules\Microsoft.PowerShell.Diagnostics\Micro
                              soft.PowerShell.Diagnostics.psd1
Definition                  :
Description                 :
Guid                        : ca046f10-ca64-4740-8ff9-2565dba61a4f
HelpInfoUri                 : https://go.microsoft.com/fwlink/?LinkID=210596
ModuleBase                  : C:\Windows\system32\WindowsPowerShell\v1.0\Modules\Microsoft.PowerShell.Diagnostics
PrivateData                 :
Version                     : 3.0.0.0
ModuleType                  : Manifest
Author                      : Microsoft Corporation
AccessMode                  : ReadWrite
ClrVersion                  : 4.0
CompanyName                 : Microsoft Corporation
Copyright                   : Microsoft Corporation. All rights reserved.
DotNetFrameworkVersion      :
ExportedFunctions           : {}
ExportedCmdlets             : {[Get-WinEvent, Get-WinEvent], [Get-Counter, Get-Counter], [Import-Counter,
                              Import-Counter], [Export-Counter, Export-Counter]...}
ExportedCommands            : {[Get-WinEvent, Get-WinEvent], [Get-Counter, Get-Counter], [Import-Counter,
                              Import-Counter], [Export-Counter, Export-Counter]...}
FileList                    : {}
ModuleList                  : {}
NestedModules               : {}
PowerShellHostName          :
PowerShellHostVersion       :
PowerShellVersion           : 3.0
ProcessorArchitecture       : None
Scripts                     : {}
RequiredAssemblies          : {}
RequiredModules             : {}
RootModule                  :
ExportedVariables           : {}
ExportedAliases             : {}
ExportedWorkflows           : {}
SessionState                :
OnRemove                    :
ExportedFormatFiles         : {C:\Windows\system32\WindowsPowerShell\v1.0\Event.format.ps1xml,
                              C:\Windows\system32\WindowsPowerShell\v1.0\Diagnostics.format.ps1xml}
ExportedTypeFiles           : {C:\Windows\system32\WindowsPowerShell\v1.0\GetEvent.types.ps1xml}

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 kullanabilirsiniz. Dışarı aktarılan diğer adlar listesinden diğer adları kaldırabilir, ancak listeye diğer ad ekleyemez.

Bu parametreyi atlarsanız, New-ModuleManifest (tümü) değerine * sahip bir AliasesToExport anahtarı oluşturur, yani modülde tanımlanan tüm diğer adlar bildirim tarafından dışarı aktarılır.

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

-Author

Modül yazarını belirtir.

Bu parametreyi atlarsanız, New-ModuleManifest geçerli kullanıcının adıyla bir Yazar anahtarı oluşturur.

Tür:String
Position:Named
Default value:Name of the current user
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-ClrVersion

Modülün gerektirdiği Microsoft .NET Framework'ün 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 küçük .NET Framework sürümleri için geçerlidir. Bu gereksinimin PowerShell'in veya .NET Framework'ün daha yeni sürümleri için hiçbir etkisi yoktur.

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.

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

Bu parametreyi atlarsanız, New-ModuleManifest (tümü) değerine * sahip bir CmdletsToExport anahtarı oluşturur, yani modülde tanımlanan tüm cmdlet'ler bildirim tarafından dışarı aktarılır.

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

-CompanyName

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

Bu parametreyi atlarsanız, New-ModuleManifest "Bilinmiyor" değerine sahip bir CompanyName anahtarı oluşturur.

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

-CompatiblePSEditions

Modülün uyumlu PSEditions'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

-Confirm

Cmdlet'i çalıştırmadan önce sizden onay ister.

Tür:SwitchParameter
Diğer adlar:cf
Position:Named
Default value:False
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

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

Bu parametreyi atlarsanız, New-ModuleManifest geçerli yıl olan ve <year> <username> Yazar anahtarının (c) <year> <username>. All rights reserved. değeri olan bir Telif Hakkı anahtarı oluşturur.

Tür:String
Position:Named
Default value:(c) <year> <username>. All rights reserved.
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-DefaultCommandPrefix

Bir oturuma aktarıldıklarında modüldeki tüm komutların adlarına eklenen bir ön ek belirtir. Bir ön ek dizesi girin. Ön ekler, kullanıcının oturumunda komut adı çakışmalarını engeller.

Modül kullanıcıları, cmdlet'in Import-Module Prefix parametresini belirterek bu ön eki geçersiz kılabilir.

Bu parametre PowerShell 3.0'da kullanıma sunulmuştur.

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 içeriğini açıklar.

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 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 küçük .NET Framework sürümleri için geçerlidir. Bu gereksinimin PowerShell'in veya .NET Framework'ün daha yeni sürümleri için hiçbir etkisi yoktur.

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ı İstenen Durum Yapılandırması (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

Bu modülün bağlı olduğu dış modüllerin listesi.

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.

Bu anahtar, modül envanteri olarak görev yapmak üzere tasarlanmıştır. Anahtarda listelenen dosyalar modül yayımlandığında eklenir, ancak işlevler otomatik olarak dışarı aktarılamaz.

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 ç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.

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.

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

Bu parametreyi atlarsanız, New-ModuleManifest (tümü) değerine * sahip bir FunctionsToExport anahtarı oluşturur, yani modülde tanımlanan tüm işlevler bildirim tarafından dışarı aktarılır.

Tür:String[]
Position:Named
Default value:* (all)
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üller arasında ayrım yapmak için kullanılabilir.

Bu parametreyi atlarsanız bildirimde New-ModuleManifest bir GUID anahtarı oluşturur ve değer için bir GUID oluşturur.

PowerShell'de yeni bir GUID oluşturmak için yazın [guid]::NewGuid().

Tür:Guid
Position:Named
Default value:A GUID generated for the module
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. http veya https ile başlayan bir Tekdüzen Kaynak Tanımlayıcısı (URI) girin.

HelpInfo XML dosyası, PowerShell 3.0'da kullanıma sunulan Güncelleştirilebilir Yardım özelliğini destekler. Modül için 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.

Bu parametre PowerShell 3.0'da kullanıma sunulmuştur.

Tür:String
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 URL'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

Bu modüle dahil edilen tüm modülleri listeler.

Her modül adı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ı 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.

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.

Bu parametre gerekli değildir, ancak bildirimde bir ModuleVersion anahtarı gereklidir. Bu parametreyi atlarsanız, New-ModuleManifest 1.0 değerine sahip bir ModuleVersion anahtarı oluşturur.

Tür:Version
Position:Named
Default value:1.0
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, değerde listelendikleri sırayla çalışır.

Her modül adı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ı birleştirebilirsiniz.

genellikle iç içe yerleştirilmiş modüller, kök modülün iç işlemesi için ihtiyaç duyduğu komutları içerir. Varsayılan olarak, iç içe modüllerdeki komutlar modülün oturum durumundan çağıranın oturum durumuna aktarılır, ancak kök modül dışarı aktardığı komutları kısıtlayabilir. Örneğin, bir Export-ModuleMember komut kullanarak.

Modül oturum durumundaki iç içe yerleştirilmiş modüller kök modülde kullanılabilir, ancak çağıranın oturum durumundaki bir Get-Module komut tarafından döndürülemez.

NestedModules anahtarında listelenen betikler (.ps1), çağıranın oturum durumunda değil modülün oturum durumunda çalıştırılır. Çağıranın oturum durumunda bir betik çalıştırmak için betik dosyası adını bildirimdeki ScriptsToProcess anahtarının değerinde listeleyin.

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

-PassThru

Elde edilen modül bildirimini konsola yazar ve bir .psd1 dosya oluşturur. Varsayılan olarak, bu cmdlet herhangi bir çıkış oluşturmaz.

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

-Path

Yeni 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. Path parametresi gereklidir.

Varolan bir dosyanın yolunu belirtirseniz, New-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ı, ancak bir .psd1 dosya adı uzantısıyla olmalıdır.

Not

Path 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.

Tür:String
Position:1
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. Windows 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.

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

PowerShell'in bu modülle çalışan en düşük sürümünü belirtir. Örneğin, parametrenin değeri olarak 1.0, 2.0 veya 3.0 girebilirsiniz. X.X biçiminde olmalıdır. Örneğin, gönderirseniz 5PowerShell bir hata oluşturur.

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

-Prerelease

Bu modülün yayın öncesi dizesi. Ön sürüm dizesi eklemek, modülü yayın öncesi sürüm olarak tanımlar. Modül PowerShell Galerisi yayımlandığında, bu veriler yayın öncesi paketleri tanımlamak için kullanılır. Galeriden yayın öncesi paketleri almak için AllowPrerelease parametresini PowerShellGet komutları Find-Module, , Install-ModuleUpdate-Moduleve Save-Moduleile kullanmanız gerekir.

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

-PrivateData

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

Tür:Object
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. Geçerli değerler x86, AMD64, IA64, MSIL ve None değerleridir (bilinmiyor veya belirtilmemiş).

Tür:ProcessorArchitecture
Kabul edilen değerler:None, MSIL, X86, IA64, Amd64, Arm
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 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

-ReleaseNotes

Sürüm notlarını 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. 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.

FormatToProcess 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 listelemek için bu parametreyi kullanın. Bu derlemeler NestedModules anahtarında ikili modüller olarak 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.

Her modül adı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ı birleştirebilirsiniz.

PowerShell 2.0'da gerekli Import-Module modülleri otomatik olarak içeri aktarmaz. Yalnızca gerekli modüllerin genel oturum durumunda olduğunu doğrular.

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ün yükleme, güncelleştirme veya kaydetme için açık kullanıcı kabulü gerekip gerekmediğini belirten bayrak.

Tür:SwitchParameter
Position:Named
Default value:None
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 (), modül bildiriminin().psd1.psm1, derlemenin (), cmdlet tanımı XML dosyasının (.dll ) veya iş akışının.cdxml (.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 hiçbir kök dosyası belirlenmezse, bildirim modülün birincil dosyası olur ve modül bir bildirim modülüne (ModuleType = Bildirim) 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.

Not

PowerShell 2.0'da bu anahtar ModuleToProcess olarak adlandırılıyordu. RootModule parametre adını veya ModuleToProcess diğer adını kullanabilirsiniz.

Tür:String
Diğer adlar:ModuleToProcess
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, oturum açma betiği gibi bir ortam hazırlamak için de kullanabilirsiniz.

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

Bu parametreyi atlarsanız, New-ModuleManifest (tümü) değerine * sahip bir VariablesToExport anahtarı oluşturur, yani modülde tanımlanan tüm değişkenler bildirim tarafından dışarı aktarılır.

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

-WhatIf

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

Tür:SwitchParameter
Diğer adlar:wi
Position:Named
Default value:False
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

Girişler

None

Nesneleri bu cmdlet'e yöneltemezsiniz.

Çıkışlar

None

Varsayılan olarak, bu cmdlet çıkış döndürmez.

String

PassThru parametresini kullandığınızda, bu cmdlet modül bildirimini temsil eden bir dize döndürür.

Notlar

New-ModuleManifestWindows ve Windows dışı platformlarda çalıştırıldığında UTF8NoBOM olarak kodlanmış modül bildirimi (.psd1) dosyaları oluşturulur.

Modül bildirimleri genellikle isteğe bağlıdır. Ancak, genel derleme önbelleğine yüklenen bir derlemeyi dışarı aktarmak için modül bildirimi gerekir.

Dizine dosya eklemek veya değiştirmek için PowerShell'i $pshome\Modules Yönetici olarak çalıştır seçeneğiyle başlatın.

Not

PowerShell 6.2 sürümünden itibaren PowerShell, modül bildiriminin FileList özelliğinde listelenen tüm DLL dosyalarını yüklemeyi dener. Yerel DLL'ler FileList içindedir, işlemde yüklenemiyor ve hata yoksayılır. Tüm yönetilen DLL'ler işlemde yüklenir. Bu davranış PowerShell 7.1'de kaldırıldı.

PowerShell 2.0'da, birçok parametresi New-ModuleManifest bir modül bildiriminde gerekli olmasa bile zorunludu. PowerShell 3.0'dan başlayarak, yalnızca Path parametresi zorunludur.

Oturum, PowerShell yürütme ortamının bir örneğidir. Bir oturumda bir veya daha fazla oturum durumu olabilir. Varsayılan olarak, bir oturumun yalnızca genel oturum durumu vardır, ancak içeri aktarılan her modülün kendi oturum durumu vardır. Oturum durumları, bir modüldeki komutların genel oturum durumunu etkilemeden çalışmasına izin verir.

Çağıranın oturum durumu, modülün içeri aktarıldığı oturum durumudur. Genellikle genel oturum durumuna başvurur, ancak modül iç içe modülleri içeri aktardığında çağıran modüldür ve çağıranın oturum durumu modülün oturum durumudur.