Microsoft PowerShell PSResourceGet modülü nasıl kurulur

PSResourceGet, Modüller, DSC Kaynakları, Rol Yetenekleri ve Komut Dosyaları gibi PowerShell yapıtlarını keşfetmeye, yüklemeye, güncellemeye ve yayınlamaya yönelik komutlar içeren bir modüldür. PSResourceGet en son paket yöneticisidir ve PowerShellGet v2 modülünün yerini alır. Bu yazımızda Microsoft PowerShell PSResourceGet modülünün nasıl kurulacağını öğreneceksiniz.

Microsoft PowerShell PSResourceGet

PSResourceGet, PowerShell Galerisi gibi depolarda modülleri ve komut dosyalarını yükleme, güncelleme ve bulma olanağı sağlayan modüldür.

PSResourceGet, PowerShell'in yeni paket yöneticisidir. PowerShellGet v2 modülünün yerini alır. Şimdi bunun neden v3 haline gelmediğini sorabilirsiniz? Projenin başlangıç aşamasındaydı. Nihayetinde pek çok kırılma noktası yaşanırken ismin de değiştirilmesine karar verildi. V3'ü PowerShell galerisinde uyumluluk modülü olarak bulacaksınız.

Windows PowerShell 5.1, PowerShellGet'in 1.0.0.1 sürümü önceden yüklenmiş olarak gelir. PowerShellGet'in bu sürümü sınırlı özelliklere sahiptir ve PowerShell Galerisi'nin güncelleştirilmiş özelliklerini desteklemez. PSResourceGet'i yüklemek için öncelikle PowerShellGet'in en son sürümüne güncellemeniz gerekir.

Microsoft PowerShell PSResourceGet modülünü yükleyin

Microsoft PowerShell PSResourceGet modülünü sisteminize kurmak için aşağıdaki adımları takip ediniz.

1. Windows PowerShell Yürütme Politikasını Ayarlayın

Varsayılan olarak komut dosyalarını yükleyemiyoruz. İnternetten indirdiğiniz tüm PowerShell komut dosyalarının güvenilir bir yayıncı tarafından imzalanmasını zorunlu kılmak için PowerShell'i yönetici olarak çalıştırın ve cmdlet'i çalıştırın.

Set-ExecutionPolicy RemoteSigned -Force

Önemli: Değişikliklerin geçerli olması için yükseltilmiş Windows PowerShell penceresini kapatıp yeniden açın.

2. PowerShellGet modülünü yükleyin

PowerShell'i yönetici olarak çalıştırın. Install-Module PowershellGet -Force komutunu çalıştırın. NuGet sağlayıcısını yüklemeniz istendiğinde Y'ye basın ve ardından Enter ile devam edin.

Install-Module PowershellGet -Force

Yüklenemediğini belirten bir hata alırsanız PowerShell için NuGet sağlayıcısı yüklenemiyor makalesini okuyun.

3. Microsoft PowerShell PSResourceGet modülünü yükleyin

Microsoft PowerShell PSResourceGet modülünü yükleyin.

Install-Module -Name Microsoft.PowerShell.PSResourceGet -Force

4. PowerShell Galeri deposuna güvenin

Microsoft PowerShell PSResourceGet'i yükledikten sonra yeni bir PowerShell oturumu açmalısınız. PowerShell cmdlet'ini kullandığınızda PowerShell, modülün en yeni sürümünü otomatik olarak yükler.

Ayrıca PowerShell Galerisini güvenilir bir depo olarak kaydetmenizi de öneririz. Bu, her modül indirmek istediğinizde depoya güvenmenizi istemeyecektir.

Set-PSResourceRepository -Name PSGallery -Trusted

PSResourceGet modülü sürümünü edinin

PSResourceGet modülünün kurulu olduğunu doğrulayın.

Get-PSResource Microsoft.PowerShell.PSResourceGet -Scope AllUsers | ft -AutoSize

Aşağıdaki PowerShell çıktısı görünür.

Version Name                               Repository Description
------- ----                               ---------- -----------
1.0.2   Microsoft.PowerShell.PSResourceGet PSGallery  PowerShell module with commands for discovering, installing, updating and publishing the PowerShell artifacts like Modules, Scripts, and DSC Resources.

PSResourceGet modülünün mevcut en son sürümünü bulun

Find-Module Microsoft.PowerShell.PSResourceGet | ft -AutoSize

Aşağıdaki çıktı görünür.

Version Name                               Repository Description
------- ----                               ---------- -----------
1.0.2   Microsoft.PowerShell.PSResourceGet PSGallery  PowerShell module with commands for discovering, installing, updating and publishing the PowerShell artifacts like Modules, Scripts, and DSC Resources.

Microsoft PowerShell PSResourceGet cmdlet'leri

Tüm cmdlet'lerin aşağıdaki listesine bakın.

Find-PSResource

Bir ada veya diğer paket özelliklerine göre bir depodaki (yerel veya uzak) paketleri arar.

Get-InstalledPSResource

PowerShellGet aracılığıyla makineye yüklenen modülleri ve komut dosyalarını döndürür.

Get-PSResourceRepository

Kayıtlı depo bilgilerini bulur ve döndürür.

Get-PSScriptFileInfo

Bir betiğin meta verilerini döndürür.

Import-PSGetRepository

PowerShellGet'e kayıtlı depoları bulur ve bunları PSResourceGet'e kaydeder.

Install-PSResource

Kaynakları kayıtlı bir depodan yükler.

New-PSScriptFileInfo

Cmdlet, komut dosyasıyla ilgili meta verileri içeren yeni bir komut dosyası oluşturur.

Publish-PSResource

Belirtilen modülü yerel bilgisayardan PSResource deposuna yayımlar.

Register-PSResourceRepository

PowerShell kaynakları için bir depo kaydeder.

Save-PSResource

Kayıtlı bir depodaki kaynakları (modüller ve komut dosyaları) makineye kaydeder.

Set-PSResourceRepository

Kayıtlı bir depoya ilişkin bilgileri ayarlar.

Test-PSScriptFileInfo

Yayınlanmak üzere geçerli olduğundan emin olmak için bir .ps1 dosyasındaki yoruma dayalı meta verileri test eder.

Uninstall-PSResource

PowerShellGet kullanılarak yüklenen bir kaynağı kaldırır.

Unregister-PSResourceRepository

Kayıtlı bir havuzu yerel makineden kaldırır.

Update-PSModuleManifest

Bir modül bildirim dosyasını günceller.

Update-PSResource

Yerel makinede önceden kurulu olan bir paketin en yeni sürümünü indirir ve yükler.

Update-PSScriptFileInfo

Bu cmdlet, mevcut bir komut dosyası .ps1 dosyasındaki yoruma dayalı meta verileri günceller.

Microsoft PowerShell PSResourceGet nasıl kullanılır?

PSResourceGet ile modüllerin nasıl kurulacağına bir göz atalım.

Kurulum-PSResource

Örneğimizde her iki modülü de kurmayı seviyoruz:

1. Microsoft Graph PowerShell modülü

2. Microsoft Graph Beta PowerShell modülü

Önceki kurulum adımlarında PSGallery'yi güvenilir depoya zaten eklediğimiz için -TrustReposority parametresini aşağıdaki komutlara eklememize gerek yok. Ama gözden kaçırmış olabilirsiniz, o yüzden ekleyelim.

Not: En son sürüm zaten kurulu olsa bile, bir modülün en son sürümünü yüklemek için komuttaki -Reinstall parametresini kullanın. Yüklü sürümün üzerine yazılır. Bu, modülün hasarlı kurulumunu onarmanıza olanak tanır. Modülün eski bir sürümü kuruluysa yeni sürüm, sürüme özel yeni bir klasörde yan yana kurulur.

Install-PSResource Microsoft.Graph -Reinstall -Scope AllUsers -TrustRepository

Install-PSResource Microsoft.Graph.Beta -Reinstall -Scope AllUsers -TrustRepository

Belirli bir modül sürümünü yüklemek istiyorsanız -Version parametresini kullanın.

Install-PSResource Microsoft.Graph -Version 2.14.0 -Scope AllUsers -TrustRepository

Install-PSResource Microsoft.Graph.Beta -Version 2.14.0 -Scope AllUsers -TrustRepository

Get-InstalledPSResource

Makinede hangi modüllerin yüklü olduğunu kontrol edin.

Get-InstalledPSResource -Scope AllUsers

Kurulu modülleri filtreleyin.

Get-InstalledPSResource Microsoft.Graph* -Scope AllUsers | Where-Object { $_.Name -notlike "Microsoft.Graph.Beta*" }

Get-InstalledPSResource Microsoft.Graph* -Scope AllUsers | Where-Object { $_.Name -like "Microsoft.Graph.Beta*" }

Modüllerin kurulu olduğu konum yolunu alalım.

Not: Bir modülü yüklemek için Install-PSResource cmdlet'ini çalıştırdığınızda, Windows PowerShell 5.1 veya PowerShell 7'den çalıştırırken modül farklı bir konuma yüklenebilir.

Get-InstalledPSResource -Scope AllUsers | ft Name, InstalledLocation

Aşağıdaki klasör yolları, modül kurulumlarının kurulduğu varsayılan yerlerdir. Aşağıdaki klasörleri Dosya Gezgini'nde açabilirsiniz.

Geçerli kullanıcı için Windows PowerShell 5.1:

%USERPROFILE%\Documents\WindowsPowerShell\Modules

Tüm kullanıcılar için Windows PowerShell 5.1:

C:\Program Files\WindowsPowerShell\Modules

Mevcut kullanıcı için PowerShell 7:

%USERPROFILE%\Documents\PowerShell\Modules

Tüm kullanıcılar için PowerShell 7:

C:\Program Files\PowerShell\Modules

Kaldırma-PSResource

PSResourceGet ile bir modülü kaldırmak istersek Uninstall-PSResource cmdlet'ini kullanmamız gerekir.

Bu, tüm Microsoft Graph modüllerini kaldıracaktır.

Get-InstalledPSResource Microsoft.Graph* -Scope AllUsers | Uninstall-PSResource -Scope AllUsers -SkipDependencyCheck

İstemediğiniz modülleri dilediğiniz zaman filtreleyebilir ve kaldırabilirsiniz.

Get-InstalledPSResource Microsoft.Graph* -Scope AllUsers | Where-Object { $_.Name -notlike "Microsoft.Graph.Beta*" } | Uninstall-PSResource -Scope AllUsers -SkipDependencyCheck

Get-InstalledPSResource Microsoft.Graph* -Scope AllUsers | Where-Object { $_.Name -like "Microsoft.Graph.Beta*" } | Uninstall-PSResource -Scope AllUsers -SkipDependencyCheck

PSResourceGet ve PowerShellGet v2 karşılaştırması

Modülleri yükleme ve kaldırma konusunda hangisinin daha hızlı olduğunu görmek için PSResourceGet ve PowerShellGet v2'yi karşılaştıralım.

Bu örnekte Microsoft Graph PowerShell modülünü kurmak ve kaldırmak için Measure-Command cmdlet'ini kullanacağız. Mükemmel bir test çünkü 39 modülü var.

PSResourceGet, PowerShellGet v2'ye kıyasla çok daha hızlıdır.

Bu kadar!

Devamını oku: PowerShell 7 Nasıl Kurulur ve Güncellenir »

Çözüm

Microsoft PowerShell PSResourceGet modülünün nasıl kurulacağını öğrendiniz. Windows PowerShell 5,1 veya PowerShell 7'yi çalıştırın ve en son PSResourceGet modülünü yüklemek için komutları adım adım çalıştırın. Artık modülleri yüklemek, güncellemek ve kaldırmak için PSResourceGet'i kullanın.

Bu makaleyi beğendiniz mi? Ayrıca Exchange Online PowerShell'e Bağlan da hoşunuza gidebilir. Bizi takip etmeyi ve bu yazımızı paylaşmayı unutmayın.