Aracılığıyla paylaş

PowerShell Galerisi'ni Kullanmaya Başlama

PowerShell Galerisi, indirip kullanabileceğiniz betikler, modüller ve DSC kaynakları içeren bir paket deposudur. PowerShell Galerisi'nden paketleri yüklemek için PowerShellGet modülündeki cmdlet'leri kullanırsınız. PowerShell Galerisi'nden öğe indirmek için oturum açmanız gerekmez.

PowerShell Galerisi'nin giriş sayfasındaki Arama denetimini kullanarak veyaPaketleri sayfasından Modüller ve Betikler'e göz atarak paketleri PowerShell Galerisi'nde bulabilirsiniz. Paket türüne bağlı olarak Find-Module, Find-DscResourceve Find-Script cmdlet'lerini -Repository PSGalleryile çalıştırarak da PowerShell Galerisi'nden paketleri bulabilirsiniz.

Galerideki sonuçları aşağıdaki parametreleri kullanarak filtreleyebilirsiniz:

  • Ad
  • AllVersions
  • MinimumVersion
  • RequiredVersion
  • Etiket
  • Içerir
  • DscResource
  • RoleCapability
  • Komut
  • Filtre

Galeride yalnızca belirli DSC kaynaklarını bulmak istiyorsanız Find-DscResource cmdlet'ini çalıştırabilirsiniz. Find-DscResource Galeri'de yer alan DSC kaynaklarıyla ilgili verileri döndürür. DSC kaynakları her zaman bir modülün parçası olarak teslim edildiğinden, bu DSC kaynaklarını yüklemek için Install-Module çalıştırmanız gerekir.

Bir paket seçtikten sonra, hakkında daha fazla bilgi edinmek isteyebilirsiniz. Galerideki paket sayfasını inceleyin. Paket sayfası, paketle birlikte yüklenen meta verileri içerir. Meta veriler paketin yazarı tarafından sağlanır. Microsoft bu bilgiyi doğrulamaz. Paketin sahibi, paketi yayınlamak için kullanılan Galeri hesabıyla ilişkilendirilir. Sahip hesabı, Yazar alanından daha otoritelidir.

İyi niyetle yayımlanmadığını düşündüğünüz bir paket bulursanız, o paketin sayfasında Kötüye Kullanım Bildir seçeneğini seçin.

Find-Module veya Find-Scriptçalıştırıyorsanız, bu verileri döndürülen PSGetModuleInfo nesnesinde görüntüleyebilirsiniz. Aşağıdaki örnek, Galeri'deki PSReadLine modülündeki verileri döndürür.

Find-Module -Name PSReadLine -Repository PSGallery | Get-Member

PowerShell Galerisi'nden paketleri indirirken aşağıdaki işlemi öneririz:

Incelemek

Galeri'den inceleme için paket indirmek için, paketteki or Save-Script cmdlet'lerini kullanınSave-Module. Bu komutlar paketi yüklemeden yerel olarak kaydeder. Paket içeriğini inceleyin. Kaydedilen paketi el ile silmeyi unutmayın.

Bazı paketler Microsoft tarafından, bazıları PowerShell topluluğu tarafından yazılır. Microsoft, yüklemeden önce bu galerideki paketlerin içeriğini ve kodunu gözden geçirmenizi önerir.

İyi niyetle yayımlanmadığını düşündüğünüz bir paket bulursanız, o paketin sayfasında Kötüye Kullanım Bildir seçeneğini seçin.

Yüklemek

Galeri'den kullanmak üzere bir paket yüklemek için paket türüne bağlı olarak Install-Module veya Install-Script cmdlet'ini çalıştırın.

Varsayılan olarak, Install-Module modül varsayılan olarak konuma $env:ProgramFiles\WindowsPowerShell\Modules kurulur ve bu da bir yönetici hesabı gerektirir. Parametreyi -Scope CurrentUser eklerseniz, komut modülü 'de $HOME\Documents\WindowsPowerShell\Modules kurulur.

Varsayılan olarak, Install-Script betikleri konuma $env:ProgramFiles\WindowsPowerShell\Scripts yükler, bu da yönetici hesabı gerektirir. Parametreyi -Scope CurrentUser eklerseniz, komut betikleri 'de $HOME\Documents\WindowsPowerShell\Scriptsyükler.

Install-Module ve Install-Script paketin en güncel sürümünü yükler. Paketin eski bir sürümünü yüklemek için -RequiredVersion parametresini ekleyin.

Dağıtmak

PowerShell Galerisi'nden Azure Automation'a bir paket dağıtmak için Azure Automation'ı seçin, ardından paket detayları sayfasında Deploy to Azure Automation'ı seçin. Azure Yönetim Portalı'na yönlendirilmişsiniz ve Azure hesap kimlik bilgilerinizle giriş yapıyorsunuz. Bağımlılıklarla paketleri dağıtmak, tüm bağımlılıkları Azure Automation'a dağıtır. Azure Otomasyonuna Dağıt butonu, paket meta verilerinize AzureAutomationNotSupported etiketi ekleyerek devre dışı bırakılabilir.

Azure Otomasyonu hakkında daha fazla bilgi edinmek için Azure Otomasyonu belgelerine bakın.

PowerShell Galerisi'nden yüklenen paketleri güncelleştirmek için Update-Module veya Update-Script cmdlet'ini çalıştırın. Başka hiçbir parametre olmadan çalıştırıldığında, Update-Module kurulan tüm modülleri çalıştırarak Install-Modulegüncellemeye çalışır. Modülleri seçmeli olarak güncelleştirmek için -Name parametresini ekleyin.

Benzer şekilde, başka parametreler olmadan çalıştırıldığında, Update-Script kurulan tüm betikleri çalıştırarak Install-Scriptgüncellemeye çalışır. Betikleri seçmeli olarak güncelleştirmek için -Name parametresini ekleyin.

PowerShell Galerisi'nden hangi modülleri kurduğunuzu öğrenmek için cmdlet'i Get-InstalledModule çalıştırın. Bu komut, sisteminizde bulunan ve doğrudan PowerShell Galerisi'nden yüklenen tüm modülleri listeler.

Benzer şekilde, PowerShell Galerisi'nden hangi betikleri yüklediğinizi öğrenmek için cmdlet'i Get-InstalledScript çalıştırın. Bu komut, sisteminizde bulunan ve doğrudan PowerShell Galerisi'nden yüklenen tüm betikleri listeler.

Önemli

PowerShell Galerisi için Aktarım Katmanı Güvenliği (TLS) 1.2 veya üzeri gerekir. TLS 1.2 veya üzerini kullanmıyorsanız PowerShell Galerisi'ne erişmeye çalışırken hata alırsınız. TLS 1.2 kullandığınızdan emin olmak için aşağıdaki komutu kullanın:

[Net.ServicePointManager]::SecurityProtocol =
    [Net.ServicePointManager]::SecurityProtocol -bor [Net.SecurityProtocolType]::Tls12

Bu konak adları, ağınızdan erişimi denetleen izin verme listelerine eklenmelidir.

Paket bulma ve indirme için gereken konaklar:

  • cdn.oneget.org
  • cdn.powershellgallery.com

PowerShell Galerisi web sitesi kullanılırken gereken konaklar:

  • *.powershellgallery.com - web sitesi
  • go.microsoft.com ve aka.ms - yeniden yönlendirme hizmetleri

Not

ile azureedge.net biten eski uç noktalar artık desteklenmiyor.

  • Last updated on