Aracılığıyla paylaş

Export-ModuleMember

Modül:
Microsoft.PowerShell.Core Module

Dışarı aktarılan modül üyelerini belirtir.

Sözdizimi

Default EnterprisePublishing 

Export-ModuleMember
    [[-Function] <String[]>]
    [-Cmdlet <String[]>]
    [-Variable <String[]>]
    [-Alias <String[]>]
    [<CommonParameters>]

Description

Export-ModuleMember cmdlet'i, bir betik modülü (.psm1) dosyasından veya New-Module cmdlet'i kullanılarak oluşturulan dinamik modülden dışarı aktarılan modül üyelerini belirtir. Modül üyeleri cmdlet'leri, işlevleri, değişkenleri ve diğer adları içerir. Bu cmdlet yalnızca bir betik modülü dosyasında veya dinamik modülde kullanılabilir.

Bir betik modülü Export-ModuleMember komutu içermiyorsa, betik modülündeki işlevler ve diğer adlar dışarı aktarılır, ancak değişkenler dışarı aktarılmaz. Bir betik modülü Export-ModuleMember komutları içerdiğinde, yalnızca Export-ModuleMember komutlarında belirtilen üyeler dışarı aktarılır. Betik modülünün diğer modüllerden içeri aktardığını üyeleri engellemek veya dışarı aktarmak için de Export-ModuleMember kullanabilirsiniz.

Export-ModuleMember komutu isteğe bağlıdır, ancak en iyi yöntemdir. Komut varsayılan değerleri doğrulasa bile modül yazarının amacını gösterir.

Örnekler

Örnek 1: Betik modülündeki işlevleri ve diğer adları dışarı aktarma

Export-ModuleMember -Function * -Alias *

Bu komut, betik modülünde tanımlanan tüm işlevleri ve diğer adları dışarı aktarır.

Örnek 2: Belirli diğer adları ve işlevleri dışarı aktarma

Export-ModuleMember -Function Get-Test, New-Test, Start-Test -Alias gtt, ntt, stt

Bu komut, betik modülünde tanımlanan üç diğer adı ve üç işlevi dışarı aktarır.

Modül üyelerinin adlarını belirtmek için bu komut biçimini kullanabilirsiniz.

Örnek 3: Üye dışarı aktarma

Export-ModuleMember

Bu komut, betik modülünde tanımlanmış hiçbir üyenin dışarı aktarılamdığını belirtir.

Bu komut modül üyelerinin dışarı aktarılmasını engeller, ancak üyeleri gizlemez. Kullanıcılar modül üyelerini okuyabilir ve kopyalayabilir veya dışarı aktarılmayan modül üyelerini çağırmak için çağrı işlecini (&) kullanabilir.

Örnek 4: Belirli bir değişkeni dışarı aktarma

Export-ModuleMember -Variable increment

Bu komut, betik modülünden yalnızca $increment değişkenini dışarı aktarır. Başka hiçbir üye dışarı aktarılmış değil.

Bir değişkeni dışarı aktarmak istiyorsanız, bir modüldeki işlevleri dışarı aktarmanın yanı sıra, Export-ModuleMember komutu tüm işlevlerin adlarını ve değişkenin adını içermelidir.

Örnek 5: Birden çok dışarı aktarma komutu

# From TestModule.psm1
function New-Test
{
    Write-Output 'I am New-Test function'
}
Export-ModuleMember -Function New-Test

function Validate-Test
{
    Write-Output 'I am Validate-Test function'
}
function Start-Test
{
    Write-Output 'I am Start-Test function'
}
Set-Alias stt Start-Test
Export-ModuleMember -Function Start-Test -Alias stt

Bu komutlar, bir betik modülü (Export-ModuleMember) dosyasında birden çok .psm1 komutlarının nasıl yorumlandığı gösterilir.

Bu komutlar üç işlev ve bir diğer ad oluşturur ve ardından iki işlevi ve diğer adı dışarı aktarır.

Export-ModuleMember komutları olmadan, işlevlerin ve diğer adın üçü de dışarı aktarılır. Export-ModuleMember komutlarıyla yalnızca New-Test ve Start-Test işlevleri ve STT diğer adı dışarı aktarılır.

Örnek 6: Dinamik modüldeki üyeleri dışarı aktarma

New-Module -Script {function SayHello {"Hello!"}; Set-Alias Hi SayHello; Export-ModuleMember -Alias Hi -Function SayHello}

Bu komut, Export-ModuleMember cmdlet'i kullanılarak oluşturulan dinamik modülde New-Module nasıl kullanılacağını gösterir.

Bu örnekte Export-ModuleMember hem Hi diğer adını hem de dinamik modüldeki SayHello işlevini dışarı aktarmak için kullanılır.

Parametreler

-Alias

Betik modülü dosyasından dışarı aktarılan diğer adları belirtir. Diğer adlar girin. 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:True
Kalan bağımsız değişkenlerden elde edilen değer:False

-Cmdlet

Betik modülü dosyasından dışarı aktarılan cmdlet'leri belirtir. Cmdlet adlarını girin. Joker karakterlere izin verilir.

Betik modülü dosyasında cmdlet'ler oluşturamazsınız, ancak ikili modüldeki cmdlet'leri bir betik modülüne aktarabilir ve betik modülünden yeniden dışarı aktarabilirsiniz.

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:True
Kalan bağımsız değişkenlerden elde edilen değer:False

-Function

Betik modülü dosyasından dışarı aktarılan işlevleri belirtir. İşlev adlarını girin. Joker karakterlere izin verilir. İşlev adı dizelerini Export-ModuleMemberde kanala ekleyebilirsiniz.

Parametre özellikleri

Tür:

String[]

Default value:None
Joker karakterleri destekler:True
DontShow:False

Parametre kümeleri

(All)
Position:0
Zorunlu:False
İşlem hattından gelen değer:True
Özellik adına göre işlem hattından gelen değer:True
Kalan bağımsız değişkenlerden elde edilen değer:False

-Variable

Betik modülü dosyasından dışarı aktarılan değişkenleri belirtir. Değişken adlarını dolar işareti karakteri ($) olmadan girin. 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:True
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

String

İşlev adı dizelerini bu cmdlet'e yöneltebilirsiniz.

Çıkışlar

None

Bu cmdlet çıkış döndürmez.

Notlar

  • Bir üyeyi dışarı aktarılan üyeler listesinden dışlamak için, diğer tüm üyeleri listeleyen ancak dışlamak istediğiniz üyeyi atlayan bir Export-ModuleMember komutu ekleyin.