Export-ModuleMember

  • Başvuru
Modül:
Microsoft.PowerShell.Core

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

Syntax

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

Description

cmdlet'i Export-ModuleMember , bir betik modülü (.psm1) dosyasından veya cmdlet kullanılarak oluşturulan dinamik modülden dışarı aktarılan modül üyelerini New-Module 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.

Betik modülü bir Export-ModuleMember komut 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. Betik modülü komutları içerdiğinde Export-ModuleMember , yalnızca komutlarda Export-ModuleMember 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 kullanabilirsiniz Export-ModuleMember .

Komut Export-ModuleMember 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ımlı 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 çağrı işlecini (&) kullanarak dışarı aktarılmayan modül üyelerini çağırabilir.

Ö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şkeni dışarı aktarır. Başka hiçbir üye dışarı aktarılmış değil.

Bir değişkeni dışarı aktarmak istiyorsanız, modüldeki işlevleri dışarı aktarmaya ek olarak, komutun Export-ModuleMember tüm işlevlerin adlarını ve değişkenin adını içermesi gerekir.

Ö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ü (.psm1) dosyasında birden çok Export-ModuleMember komutun nasıl yorumlandığı gösterir.

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.

Komutlar Export-ModuleMember olmadan, işlevlerin ve diğer adın üçü de dışarı aktarılır. Komutlarla Export-ModuleMember 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, cmdlet'i kullanılarak oluşturulan dinamik modülde New-Module nasıl kullanılacağını Export-ModuleMember gösterir.

Bu örnekte, Export-ModuleMember dinamik modülde Hi hem diğer adı hem SayHello de işlevi 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.

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

-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 bir ikili modüldeki cmdlet'leri bir betik modülüne aktarabilir ve betik modülünden yeniden dışarı aktarabilirsiniz.

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

-Function

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

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

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

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

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 çıkarmak için, diğer tüm üyeleri listeleyen ancak dışlamak istediğiniz üyeyi atlayan bir Export-ModuleMember komut ekleyin.