New-ModuleManifest
Yeni bir modül bildirimi oluşturur.
Sözdizimi
All
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'i 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 .psd1 dosyasıdır. 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 PassThrudışı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 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, yalnızca gerekli parametre değerleri belirtilmediğinde New-ModuleManifest istemler.
Modülünüzü PowerShell Galerisi'nde yayımlamayı planlıyorsanız bildirim belirli özelliklere yönelik değerler içermelidir. Daha fazla bilgi için, Galeri belgelerindeki PowerShell Galerisi'ne 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 dosyaya 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ı ve karma tablo biçimini belirterek adı, GUIDve PSScheduledJob modülünün sürümünü belirtmek için bir dize 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, RequiredModulesve 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 örnekte, modül bildiriminde bir HelpInfoUri anahtarı oluşturmak için HelpInfoUri parametresi kullanılı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 parametresini kullanarak Microsoft.PowerShell.Diagnostics modülünü elde etmek için kullanılır. komutu, modül nesnesinin tüm özelliklerini ve değerlerini görüntülemek için modülü Format-List 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ışa aktardığı takma 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 adları ekleyemez.
Bu parametreyi atlarsanız, New-ModuleManifest (tümü) değerine sahip bir * anahtarı oluşturur ve bu da modülde tanımlanan tüm diğer adların bildirim tarafından dışarı aktarılmasını sağlar.
Parametre özellikleri
| Tür: | String[] |
| Default value: | * (all) |
| Joker karakterleri destekler: | True |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-Author
Modül yazarını belirtir.
Bu parametreyi atlarsanız, New-ModuleManifest geçerli kullanıcının adıyla bir Author anahtarı oluşturur.
Parametre özellikleri
| Tür: | String |
| Default value: | Name of the current user |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | 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.
Uyarı
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.
Parametre özellikleri
| Tür: | Version |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | 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 * anahtarı oluşturur, yani modülde tanımlanan tüm cmdlet'ler bildirim tarafından dışarı aktarılır.
Parametre özellikleri
| Tür: | String[] |
| Default value: | * (all) |
| Joker karakterleri destekler: | True |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-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.
Parametre özellikleri
| Tür: | String |
| Default value: | Unknown |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-CompatiblePSEditions
Modülün uyumlu PSEditions'larını belirtir. PSEdition hakkında bilgi için, uyumlu PowerShell sürümleri ile modüllere bakın.
Parametre özellikleri
| Tür: | String[] |
| Default value: | None |
| Kabul edilen değerler: | Desktop, Core |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-Confirm
Cmdlet'i çalıştırmadan önce sizden onay ister.
Parametre özellikleri
| Tür: | SwitchParameter |
| Default value: | False |
| Joker karakterleri destekler: | False |
| DontShow: | False |
| Diğer adlar: | Cf |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-Copyright
Modül için bir telif hakkı bildirimi belirtir.
Bu parametreyi atlarsanız New-ModuleManifest, geçerli yıl ve (c) <year> <username>. All rights reserved.<year> anahtarının değeri olan <username> değerine sahip bir Telif Hakkı anahtarı oluşturur.
Parametre özellikleri
| Tür: | String |
| Default value: | (c) <year> <username>. All rights reserved. |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | 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 parametresini belirterek bu ön eki geçersiz kılabilir.
Bu parametre PowerShell 3.0'da kullanıma sunulmuştur.
Parametre özellikleri
| Tür: | String |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-Description
Modülün içeriğini açıklar.
Parametre özellikleri
| Tür: | String |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-DotNetFrameworkVersion
Modülün gerektirdiği en düşük Microsoft .NET Framework sürümünü belirtir.
Uyarı
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.
Parametre özellikleri
| Tür: | Version |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-DscResourcesToExport
Modülün dışarı aktardığını İstenen Durum Yapılandırması (DSC) kaynaklarını belirtir. Joker karakterlere izin verilir.
Parametre özellikleri
| Tür: | String[] |
| Default value: | None |
| Joker karakterleri destekler: | True |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-ExternalModuleDependencies
Bu modülün bağlı olduğu dış modüllerin listesi. Bu liste yalnızca modülün bağımlılıklarını belgelemesi için kullanılır ve PowerShell tarafından zorlanmaz. PowerShellGet veya PSResourceGet komutları veya PowerShell Galerisi tarafından kullanılmaz.
Parametre özellikleri
| Tür: | String[] |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | 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.
Parametre özellikleri
| Tür: | String[] |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | 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, belirtilen dosyalarla Update-FormatData cmdlet'ini çalıştırır.
Biçimlendirme dosyalarının kapsamı olmadığından, bunlar oturumdaki tüm oturum durumlarını etkiler.
Parametre özellikleri
| Tür: | String[] |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | 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. İhraç edilen takma 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.
Parametre özellikleri
| Tür: | String[] |
| Default value: | * (all) |
| Joker karakterleri destekler: | True |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-Guid
Modül için benzersiz bir tanımlayıcı belirtir. GUID, aynı ada sahip modülleri ayırt etmek için kullanılabilir.
Bu parametreyi atlarsanız, New-ModuleManifest bildirimde bir GUID anahtarı oluşturur ve değer için bir GUID oluşturur.
PowerShell'de yeni bir GUID oluşturmak için [guid]::NewGuid()yazın.
Parametre özellikleri
| Tür: | Guid |
| Default value: | A GUID generated for the module |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-HelpInfoUri
Modülün HelpInfo XML dosyasının internet adresini belirtir. http veya httpsile 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.
Parametre özellikleri
| Tür: | String |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-IconUri
Modül için bir simgenin URL'sini belirtir. Belirtilen simge, modülün galeri web sayfasında görüntülenir.
Parametre özellikleri
| Tür: | Uri |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-LicenseUri
Modülün lisans koşullarının URL'sini belirtir.
Parametre özellikleri
| Tür: | Uri |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-ModuleList
Bu modüle dahil edilen tüm modülleri listeler.
Her bir modül adını bir dize olarak veya ModuleName ve ModuleVersion anahtarlarına sahip bir hash tablosu 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.
Parametre özellikleri
| Tür: | Object[] |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | 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.
Parametre özellikleri
| Tür: | Version |
| Default value: | 1.0 |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | 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ıştırılır.
Her bir modül adını bir dize olarak veya ModuleName ve ModuleVersion anahtarlarına sahip bir hash tablosu 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 komutu kullanarak.
Modül oturum durumundaki iç içe yerleştirilmiş modüller kök modülde kullanılabilir, ancak çağıranın oturum durumundaki Get-Module komutu tarafından döndürülmez.
.ps1 anahtarında listelenen betikler (), ç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.
Parametre özellikleri
| Tür: | Object[] |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-PassThru
Elde edilen modül bildirimini konsola yazar ve bir .psd1 dosyası oluşturur. Varsayılan olarak, bu cmdlet herhangi bir çıkış oluşturmaz.
Parametre özellikleri
| Tür: | SwitchParameter |
| Default value: | False |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-Path
Yeni modül bildiriminin yolunu ve dosya adını belirtir.
.psd1gibi $PSHOME\Modules\MyModule\MyModule.psd1 dosya adı uzantısına sahip bir yol ve dosya adı girin.
Path parametresi gereklidir.
Var olan 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ı olmalı, ancak .psd1 dosya adı uzantısına sahip olmalıdır.
Uyarı
$PSHOME parametre değeri istemine cevap verirken $HOME veya gibi değişkenleri kullanamazsınız. Değişken kullanmak için komutuna Path parametresini ekleyin.
Parametre özellikleri
| Tür: | String |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | 1 |
| Zorunlu: | True |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-PowerShellHostName
Modülün gerektirdiği PowerShell konak programının adını belirtir. Windows PowerShell ISE Ana Bilgisayarı veya ConsoleHostgibi konak programının adını girin. Joker karakterlere izin verilmez.
Bir konak programının adını bulmak için, programda $Host.Nameyazın.
Parametre özellikleri
| Tür: | String |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | 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.
Parametre özellikleri
| Tür: | Version |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | 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, 5gönderirseniz PowerShell bir hata oluşturur.
Parametre özellikleri
| Tür: | Version |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-Prerelease
Bu modülün yayın öncesi metni. Ön sürüm dizesi eklemek, modülü yayın öncesi sürüm olarak tanımlar. Modül PowerShell Galerisi'nde 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-Module, Update-Moduleve Save-Moduleile kullanmanız gerekir.
Parametre özellikleri
| Tür: | String |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-PrivateData
modül içeri aktarıldığında modüle geçirilen verileri belirtir.
Parametre özellikleri
| Tür: | Object |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | 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ş).
Parametre özellikleri
| Tür: | ProcessorArchitecture |
| Default value: | None |
| Kabul edilen değerler: | None, MSIL, X86, IA64, Amd64, Arm |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-ProjectUri
Bu projeyle ilgili bir web sayfasının URL'sini belirtir.
Parametre özellikleri
| Tür: | Uri |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-ReleaseNotes
Sürüm notlarını belirtir.
Parametre özellikleri
| Tür: | String |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | 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ı değerinde belirtilen modül dosyasını içeri aktarmadan önce belirtilen derlemeleri yükler.
FormatsToProcess veya TypesToProcess anahtarlarında listelenen tüm 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ş olsalar bile).
Parametre özellikleri
| Tür: | String[] |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | 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 komutu başarısız olur.
Her bir modül adını bir dize olarak veya ModuleName ve ModuleVersion anahtarlarına sahip bir hash tablosu olarak girin. Karma tablo isteğe bağlı bir GUID anahtarına da sahip olabilir. Parametre değerinde dizeleri ve karma tabloları birleştirebilirsiniz.
veya Install-PSResource komutlarını Install-Module kullanarak bir modül yüklediğinizde, bu komutlar bu listeyi denetler. Gerekli modüller yüklü değilse, komutlar gerekli modülleri yüklemeyi dener.
Parametre özellikleri
| Tür: | Object[] |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-RequireLicenseAcceptance
Modülün yükleme, güncelleştirme veya kaydetme için açık kullanıcı kabulü gerekip gerekmediğini belirten bayrak.
Parametre özellikleri
| Tür: | SwitchParameter |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | 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(.psd1), derlemenin (.dll), cmdlet tanım XML dosyasının (.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 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 dosyalardan üyeleri dışarı aktarmak için, bu dosyaların adları bildirimdeki RootModule veya nestedModules anahtarları değerlerinde belirtilmelidir. Aksi takdirde, onların üyeleri dışarıya aktarılmaz.
Uyarı
PowerShell 2.0'da bu anahtar ModuleToProcessolarak adlandırıldı. RootModule parametre adını veya ModuleToProcess takma adını kullanabilirsiniz.
Parametre özellikleri
| Tür: | String |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
| Diğer adlar: | ModuleToProcess |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | 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ışan betikleri belirtmek için NestedModules anahtarını kullanın.
Parametre özellikleri
| Tür: | String[] |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-Tags
Bir etiket dizisi belirtir.
Parametre özellikleri
| Tür: | String[] |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | 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, belirtilen dosyalarla Update-TypeData cmdlet'ini çalıştırır.
Tür dosyalarının bir kapsamı olmadığı için, bunlar oturumdaki tüm durumları etkiler.
Parametre özellikleri
| Tür: | String[] |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | 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 * anahtarı oluşturur, yani modülde tanımlanan tüm değişkenler bildirim tarafından dışarı aktarılır.
Parametre özellikleri
| Tür: | String[] |
| Default value: | * (all) |
| Joker karakterleri destekler: | True |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-WhatIf
New-ModuleManifest çalıştırıldığında ne olacağını gösterir. Cmdlet çalıştırılmıyor.
Parametre özellikleri
| Tür: | SwitchParameter |
| Default value: | False |
| Joker karakterleri destekler: | False |
| DontShow: | False |
| Diğer adlar: | Wi |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
CommonParameters
Bu cmdlet yaygın parametreleri destekler: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction ve -WarningVariable. Daha fazla bilgi için bkz. about_CommonParameters.
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
Windows ve Windows dışı platformlarda çalışan New-ModuleManifest, UTF8NoBOM .psd1olarak kodlanmış modül bildirimi () dosyaları oluşturur.
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.
$PSHOME\Modules dizinine dosya eklemek veya değiştirmek için PowerShell'i yönetici olarak çalıştır seçeneğiyle başlatın.
Uyarı
PowerShell 6.2 sürümünden başlayarak 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ıyor. Tüm yönetilen DLL'ler işlemde yüklenir. Bu davranış PowerShell 7.1'de kaldırıldı.
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.
PowerShell 2.0'da, bir modül bildiriminde gerekli olmasa bile New-ModuleManifest birçok parametresi zorunludu. PowerShell 3.0'dan başlayarak, yalnızca Yolu parametresi zorunludur.
PowerShell 2.0'da Import-Module gerekli modülleri otomatik olarak içeri aktarmaz. Yalnızca gerekli modüllerin genel oturum durumunda olduğunu doğrular.
