PowerShell Galerisi Kullanmaya Başlama
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 gelen paketleri bulma
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-DscResource
ve Find-Script
cmdlet'lerini ile -Repository PSGallery
çalıştırarak Find-Module
da 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.
PowerShell Galerisi paketleri hakkında bilgi edinme
İ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
PowerShell Galerisi'dan paketleri indirme
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'den paketleri güncelleştirme
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-Module
yü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-Script
yüklenen tüm betikleri güncelleştirmeye çalışır. Betikleri seçmeli olarak güncelleştirmek için parametresini -Name
ekleyin.
PowerShell Galerisi'dan yüklediğiniz paketleri listeleme
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.
PowerShell Galerisi ağ erişimi
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 sitesigo.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.
İlgili bağlantılar
PowerShellGet & Gallery