New-ModuleManifest
Yeni bir modül bildirimi oluşturur.
Syntax
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 @moduleSettingsBu ö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 @moduleSettingsGü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.
| Type: | String[] |
| Position: | Named |
| Default value: | * (all) |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | String |
| Position: | Named |
| Default value: | Name of the current user |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| 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 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.
| Type: | String[] |
| Position: | Named |
| Default value: | * (all) |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | String |
| Position: | Named |
| Default value: | "Unknown" |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | String[] |
| Accepted values: | Desktop, Core |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Confirm
Cmdlet'i çalıştırmadan ö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.
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.
| Type: | String |
| Position: | Named |
| Default value: | (c) <year> <username>. All rights reserved. |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Description
Modülün içeriğini açıklar.
| 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 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.
| 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ı İstenen Durum Yapılandırması (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
Bu modülün bağlı olduğu dış modüllerin listesi.
| 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.
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.
| 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 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.
| Type: | String[] |
| Position: | Named |
| Default value: | * (all) |
| 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.
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().
| Type: | Guid |
| Position: | Named |
| Default value: | A GUID generated for the module |
| 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 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.
| Type: | String |
| 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
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.
| 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.
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.
| Type: | Version |
| Position: | Named |
| Default value: | 1.0 |
| 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.
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.
| Type: | Object[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | String |
| Position: | 1 |
| 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. 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.
| 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
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.
| Type: | Version |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| 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: | Object |
| 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. Geçerli değerler x86, AMD64, IA64, MSIL ve None değerleridir (bilinmiyor veya belirtilmemiş).
| 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
Sürüm notlarını 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.
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.
| 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.
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.
| Type: | Object[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RequireLicenseAcceptance
Modülün yükleme, güncelleştirme veya kaydetme için açık kullanıcı kabulü gerekip gerekmediğini belirten bayrak.
| 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 (), 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.
| Type: | String |
| Aliases: | ModuleToProcess |
| 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, 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.
| 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 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.
| Type: | String[] |
| Position: | Named |
| Default value: | * (all) |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | True |
-WhatIf
Çalıştırılırsa New-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
None
Nesneleri bu cmdlet'e yöneltemezsiniz.
Çıkışlar
None
Varsayılan olarak, bu cmdlet çıkış döndürmez.
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.
İlişkili Bağlantılar
PowerShell
Geri Bildirim
Ç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. https://aka.ms/ContentUserFeedback.
Gönderin ve geri bildirimi görüntüleyin