PowerShell İçe Aktarma Modülü | PowerShell İçe Aktarma Modülünün En Önemli Örnekleri

PowerShell İçe Aktarma Modülüne Giriş

Modül, bir paket halinde bir araya getirilen cmdlet'ler, değişkenler, işlevler ve iş akışları koleksiyonudur. Modüller ilk olarak PowerShell sürüm 2'de tanıtıldı. Modüller genellikle aşağıdaki iki birincil konumda depolanır. Bu konumuzda PowerShell Import Modülünü öğreneceğiz.

  • %windir%\system32\WindowsPowerShell\v1.0\Modules bu, sistemdeki herhangi bir kullanıcının kullanabileceği sistem çapındaki modüllerin konumudur.
  • %USERPROFILE%\Documents\WindowsPowerShell\Modules

Her modülün kaydedildiği özel bir klasörü vardır. Ayrıca Modül Bildirimi adı verilen bir psd1 dosyası da içerir. Bildirim dosyası, PowerShell sürümü, yazar ve diğer ayarlar gibi modülün ayarlarını içerir. Kullanılabilir modüllerin listesi Get-Module -ListAvailable cmdlet'ini çalıştırarak elde edilebilir.

Bir Modülü İçe Aktarma

Modüller bir oturumda Import-Module cmdlet'i kullanılarak içe aktarılabilir. Bir modülün içe aktarılabilmesi için sistemde ya da uzak bir sunucuda bulunması gerekmektedir. PowerShell 3.0'dan başlayarak, yüklü modüldeki herhangi bir cmdlet ilk kez çalıştırıldığında Modüller otomatik olarak içe aktarılır. $PSModuleAutoloadingPreference tercih değişkeni, modüllerin otomatik olarak içe aktarılmasını etkinleştirmek veya devre dışı bırakmak için kullanılır. Import-Module cmdlet'leri varsayılan olarak tüm üyeleri içe aktarır; bu, takma ad veya değişken parametreler kullanılarak kısıtlanabilir.

İçe Aktarma Modülünün Sözdizimi

İçe Aktarma Modülü Cmdlet'inin sözdizimi aşağıdadır

Parametreler

Import-Module Cmdlet'iyle ilişkili birçok parametre vardır; yaygın olarak kullanılan parametrelerden birkaçı aşağıda tartışılacaktır.

1. Takma ad

Bu, modülden geçerli oturuma aktarılacak takma adların listesini belirtir. Bazı modüller seçilen takma adı varsayılan olarak otomatik olarak dışa aktarır. Türü bir dizedir ve varsayılan değer none'dur. Boru hattı girişini ve joker karakterleri kabul etmez. İsteğe bağlı bir parametredir.

2. İsim

Bu zorunlu bir parametredir. Bu, içe aktarılacak modüllerin adlarını temsil eder. Ad, bir modülü veya modülün içindeki bir dll veya .ps1 dosyası gibi bir dosyayı temsil edebilir. Her zaman modül adını kullanmak akıllıca olacaktır. Türü bir dizedir. Varsayılan değer hiçbiridir. Boru hattı girişini ve joker karakterleri kabul eder.

3.Önek

Bu, içe aktarılan modül üyelerinin adlarına eklenecek öneki belirtir. Bu, geçerli oturumdaki modül üyelerini etkiler. Türü bir dizedir ve varsayılan değer none'dur. Boru hattı girişini ve joker karakterleri kabul etmez.

4. Gerekli Sürüm

Belirtilen sürümün mevcut olmaması durumunda bir hata oluşması durumunda, içe aktarılması gereken modülün sürümünü belirtir. Türü version'dur ve varsayılan değer none'dur. Boru hattı girişini ve joker karakterleri kabul etmez.

5. Kapsam

Modülün içe aktarılması gereken kapsamı belirtir. Küresel ya da yerel olabilir. Genel olarak oturumdaki tüm komutlar için kullanılabilir ve yerel olarak yalnızca geçerli kapsam içindir. Türü bir dizedir ve varsayılan değer hiçbiridir. Boru hattı girişini ve joker karakterleri kabul etmez.

6. Değişken

Modülden geçerli oturuma aktarılması gereken değişkenlerin listesini belirtir. Türü bir dizedir ve varsayılan değer hiçbiridir. Boru hattı girişini kabul etmez ancak joker karakterler kabul edilir.

Örnekler

Aşağıda belirtilen PowerShell İçe Aktarma Modülü örnekleri verilmiştir

Örnek #1

Bir modülü içe aktarma ve modüldeki komutları alma

Giriş:

Write-Host "Welcome to Import Module Tutorial" -ForegroundColor Green
Write-Host "List of modules available in the current session are below" -ForegroundColor Green
Get-Module -All
Write-Host "Importing Diagnostics Module" -ForegroundColor Green
Import-Module -Name PSDiagnostics
Write-Host "Commands available in PSDiagnostics are follows" -ForegroundColor Green
Get-Command -Module PSDiagnostics -TotalCount 1

Çıktı:

Örnek #2

Bir Modülü İçe Aktarma ve Bir Modülü Kaldırma ile birlikte ayrıntılı kullanım:

Verbose parametresi, içe aktarılan modülde bulunan çeşitli komut dosyalarını, işlevleri, değişkenleri ve iş akışlarını listelemek için kullanılır.

Giriş:

Write-Host "Welcome to verbose and removal of module tutorial" -ForegroundColor Green
Write-Host "Importing Diagnostics Module with verbose parameter" -ForegroundColor Green
Import-Module -Name PSDiagnostics -Verbose
Write-Host "Removing the module from the current session" -ForegroundColor Green
Remove-Module -Name PSDiagnostics
Write-Host "Successfully remove the Module"

Çıktı:

Örnek #3

İçe aktarılan üyelerin kısıtlanması:

Yukarıda belirtildiği gibi, bir modülün üyelerinin içe aktarılmasını kısıtlamak mümkündür. Bir modül 100 komut ve fonksiyona sahip olabilir. Sadece birkaçı kullanılacaksa hepsini içe aktarmanız önerilmez. Tümünü almaktansa yalnızca gerekli üyeleri almak daha iyidir. Aşağıdaki örnek, üyelerin nasıl kısıtlanacağını gösterir.

Giriş:

Write-Host "Welcome to the tutorial of restricting cmdlets from being imported" -ForegroundColor Green
Write-Host "The following are the available cmdlets in the PSDiagnostics Module" -ForegroundColor Green
(Get-Module PSDiagnostics).ExportedCommands
#mention only start and stop to be imported
Write-Host "Lets see how to import only start the trace and stop trace" -ForegroundColor Green
Import-Module PSDiagnostics -Function Start-Trace , Stop-Trace
Write-Host "only stop and start trace are imported" -ForegroundColor Green
Write-Host "imported cmdlets are as below" -ForegroundColor Green
Get-Command -Module PSDiagnostics

Çıktı:

Örnek #4

Bir modülü yeniden içe aktarma, önek ekleme ve modülün yalnızca belirli bir sürümünü alma:

Giriş:

Write-Host "welcome to prefix tutorial" -ForegroundColor Green
Write-Host "Importing PSDiagnostics for first time" -ForegroundColor Green
Import-Module PSDiagnostics
Write-Host "Module Imported"
Write-Host "Importing PSDiagnostics for second  time with prefix" -ForegroundColor Green
Import-Module PSDiagnostics -Force -Prefix Px
Write-Host "List of commands with prefix px" -ForegroundColor Green
Get-Command -Module PSDiagnostics
Write-Host "Importing PowerShell get module with 3.0 version" -ForegroundColor Green
Import-Module -Name PowerShellGet -MinimumVersion 3.0.0
Write-Host "Module imported"

Çıktı:

Aşağıda vurgulanan alan önekleri göstermektedir.

Sonuç - PowerShell İçe Aktarma Modülü

Bu nedenle makalede, Import-Module Cmdlet'i ayrıntılı olarak ele alınmıştır. Ayrıca bir modülün nasıl içe aktarılabileceği, bir modülü içe aktarmanın çeşitli yolları, içe aktarılması gereken komutların ve işlevlerin filtrelenmesi uygun örneklerle birlikte açıklandı. Cmdlet hakkında derinlemesine bilgi edinmek için örnek programlar oluşturmanız ve bunların etrafında çalışarak eğlenmeniz önerilir.

İlgili makaleler