PowerShell Galerisi Kullanmaya Başlama

  • Makale

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

Not

Paketi doğrudan PowerShell Galerisi'dan indirmek mümkündür, ancak bu önerilen bir yaklaşım değildir. Diğer ayrıntılar için bkz. El ile Paket İndirme.

PowerShell Galerisi giriş sayfasındakiArama denetimini kullanarak veya Paketler sayfasındaki Modüller ve Betikler'e göz atarak paketleri PowerShell Galerisi bulabilirsiniz. paket türüne bağlı olarak , Find-DscResourceve Find-Script cmdlet'lerini ile -Repository PSGalleryçalıştırarak Find-Moduleda PowerShell Galerisi gelen paketleri bulabilirsiniz.

Aşağıdaki parametreleri kullanarak Galeri'den sonuçları filtreleyebilirsiniz:

  • Name
  • AllVersions
  • MinimumVersion
  • RequiredVersion
  • Etiket
  • Dahil Eder
  • DscResource
  • RoleCapability
  • Komut
  • Filtre

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

İlgilendiğiniz bir paket belirledikten sonra bu paket hakkında daha fazla bilgi edinmek isteyebilirsiniz. Bu işlemi, söz konusu paketin Galerideki belirli sayfasını inceleyerek yapabilirsiniz. Bu sayfada, paketle birlikte karşıya yüklenen tüm meta verileri görebilirsiniz. Bu meta veriler paketin yazarı tarafından sağlanır ve Microsoft tarafından doğrulanmaz. Paketin Sahibi, paketi yayımlamak için kullanılan Galeri hesabına güçlü bir şekilde bağlıdır ve Yazar alanından daha güvenilirdir.

İyi niyetle yayımlanmadığını düşünüyorsanız paketin sayfasında Uygunsuz Kullanımı Bildir'e tıklayın.

veya Find-ScriptçalıştırıyorsanızFind-Module, 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

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

Incelemek

İnceleme için Galeri'den bir paket indirmek için paket türüne bağlı olarak veya Save-Script cmdlet'ini çalıştırınSave-Module. Bu, paketi yüklemeden yerel olarak kaydetmenizi ve paket içeriğini incelemenizi sağlar. Kaydedilen paketi el ile silmeyi unutmayın.

Bu paketlerden bazıları Microsoft tarafından, diğerleri ise 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üşünüyorsanız paketin sayfasında Uygunsuz Kullanımı Bildir'e tıklayın.

Yükleme

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

Install-Module modülü varsayılan olarak 'a $env:ProgramFiles\WindowsPowerShell\Modules yükler. Bunun için bir yönetici hesabı gerekir. parametresini -Scope CurrentUser eklerseniz modülü öğesine $HOME\Documents\WindowsPowerShell\Modules yüklenir.

Install-Script betiği varsayılan olarak 'a $env:ProgramFiles\WindowsPowerShell\Scripts yükler. Bunun için bir yönetici hesabı gerekir. parametresini -Scope CurrentUser eklerseniz, betik öğesine $HOME\Documents\WindowsPowerShell\Scripts yüklenir.

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

Dağıtma

paketi PowerShell Galerisi Azure Otomasyonu dağıtmak için Azure Otomasyonu'a tıklayın ve ardından paket ayrıntıları sayfasındaki Azure Otomasyonu dağıt'a tıklayın. Azure hesabı kimlik bilgilerinizi kullanarak oturum açtığınızda Azure Yönetim Portalı'na yönlendirilirsiniz. Paketlerin bağımlılıklarla dağıtılmasıyla tüm bağımlılıkların Azure Otomasyonu dağıtıldığını unutmayın. 'Azure Otomasyonu dağıt' düğmesi, paket meta verilerinize AzureAutomationNotSupported etiketi eklenerek devre dışı bırakılabilir.

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

PowerShell Galerisi yüklenen paketleri güncelleştirmek için veya Update-Script cmdlet'ini Update-Module çalıştırın. Herhangi bir ek parametre olmadan çalıştırıldığında, Update-Module komutunu çalıştırarak Install-Moduleyüklenen tüm modülleri güncelleştirmeye çalışır. Modülleri seçmeli olarak güncelleştirmek için parametresini -Name ekleyin.

Benzer şekilde, ek parametre olmadan çalıştırıldığında da Update-Script çalıştırılarak Install-Scriptyüklenen tüm betikleri güncelleştirmeye çalışır. Betikleri seçmeli olarak güncelleştirmek için parametresini -Name ekleyin.

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

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

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

Paket bulma ve indirme için gereken konaklar:

  • onegetcdn.azureedge.net - CDN ana bilgisayar adı

PowerShell Galerisi web sitesini kullanırken gereken konaklar:

  • devopsgallerystorage.blob.core.windows.net - depolama hesabı ana bilgisayar adı
  • *.powershellgallery.com -Web sitesi
  • go.microsoft.com - yeniden yönlendirme hizmeti

Önemli

Nisan 2020 itibarıyla PowerShell Galerisi artık Aktarım Katmanı Güvenliği (TLS) 1.0 ve 1.1 sürümlerini desteklememektedir. TLS 1.2 veya üzerini kullanmıyorsanız, PowerShell Galerisi erişmeye çalışırken bir 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

Daha fazla bilgi için PowerShell blogundaki duyuruya bakın.