Başlarken ile PowerShell Galerisi

Bu PowerShell Galerisi, indirilebilirsiniz ve yararlanabilirsiniz betikler, modüller ve DSC kaynakları içeren bir paket deposu. PowerShellGet modülünde cmdlet'leri kullanarak paketlerden PowerShell Galerisi. Dosyadan öğeleri indirmek için oturum PowerShell Galerisi.

Not

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

Paketleri, PowerShell Galerisi sayfasındaki Arama PowerShell Galerisi kullanarak veya Paketler sayfasındaki Modüller ve Betikler'e göz atarak bulabilirsiniz. Paket türüne bağlı olarak PowerShell Galerisi find-module, Find-DscResourceve Find-Script cmdlet'lerini ile çalıştırarak da paket paketinden paketleri -Repository PSGallery bulabilirsiniz.

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

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

Galeri'de yalnızca belirli DSC kaynaklarını bulmakla ilgileniyorsanız Find-DscResource cmdlet'ini ç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 edilir, ancak yine de bu DSC kaynaklarını yüklemek için Install-Module'i çalıştırmanız gerekir.

İlgilenilen bir paket belirlediktan sonra, bu paket hakkında daha fazla bilgi edinmek iyi olabilir. Bunu yapmak için Galeri'de paketin belirli sayfasını inceleyebilirsiniz. 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 kesinlikle bağlanır ve Yazar alanından daha güvenilirdir.

İyi bir şekilde yayımlanmaz gibi bir paket fark edersiniz, bu Uygunsuz Kullanımı Bildirin sayfasındaki Ekle'ye tıklayın.

Find-Module veya Find-Scriptçalıştırdısanız, bu verileri döndürülen PSGetModuleInfo nesnesinde görüntüebilirsiniz. Örneğin, Find-Module -Name PSReadLine -Repository PSGallery |Get-Member çalıştırma, Galeri'de PSReadLine modülünde verileri döndürür.

PowerShell Galerisi'den paket indirirken aşağıdaki işlemi PowerShell Galerisi:

Incelemek

Galeri'den inceleme için bir paket indirmek için paket türüne bağlı olarak Save-Module veya Save-Script cmdlet'ini çalıştırın. 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, bazıları ise PowerShell topluluğu tarafından yazar. Microsoft, yüklemeden önce bu galeride yer alan paketlerin içeriğini ve kodunu gözden geçirmenizi öneririz.

İyi bir şekilde yayımlanmaz gibi bir paket fark edersiniz, bu Uygunsuz Kullanımı Bildirin sayfasındaki Ekle'ye tıklayın.

Yükleme

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

Install-Module, modülü varsayılan olarak $env:ProgramFiles\WindowsPowerShell\Modules 'a yüklüdür. Bunun için bir yönetici hesabı gerekir. parametresini -Scope CurrentUser eklersiniz, modülü 'ye $env:USERPROFILE\Documents\WindowsPowerShell\Modules yüklenir.

Betiği Yükle varsayılan olarak $env:ProgramFiles\WindowsPowerShell\Scripts 'a yüklenir. Bunun için bir yönetici hesabı gerekir. parametresini -Scope CurrentUser eklersiniz, betik 'e $env:USERPROFILE\Documents\WindowsPowerShell\Scripts yüklenir.

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

Dağıtma

Paketten PowerShell Galerisi'Azure Otomasyonu dağıtmak için, Azure Otomasyonu'a tıklayın ve ardından paket ayrıntıları sayfasında Azure Otomasyonu'ye dağıt'a tıklayın. Azure hesabı kimlik bilgilerinizi kullanarak Yönetim Portalı azure hesabına yeniden yönlendirildiniz. Paketleri bağımlılıklarla dağıtmanın tüm bağımlılıkları dağıtım paketine Azure Otomasyonu. Paket meta verilerinize AzureAutomationNotSupported etiketini ekleyerek 'Azure Otomasyonu'a dağıt' düğmesi devre dışı bırakılabilir.

Daha fazla bilgi Azure Otomasyonu için bkz. Azure Otomasyonu.

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

Benzer şekilde, Herhangi bir ek parametre olmadan çalıştırıldık, Update-Script de Install-Script çalıştırarak yüklü tüm betikleri güncelleştirmeye çalışır. Betikleri seçmeli olarak güncelleştirmek için parametresini -Name ekleyin.

Modülden hangi modülleri yüklemiş olduğunu bulmak PowerShell Galerisi Get-InstalledModule cmdlet'ini çalıştırın. Bu komut, sisteminize sahip olan ve doğrudan sistemden yüklenmiş olan tüm modülleri PowerShell Galerisi.

Benzer şekilde, dosyadan hangi betikleri yüklemiş PowerShell Galerisi Get-InstalledScript cmdlet'ini çalıştırın. Bu komut, doğrudan sistemden yüklenmiş olan sisteminize sahip olan tüm betikleri PowerShell Galerisi.

Aşağıdaki PowerShell Galerisi ana bilgisayar adlarını kullanır.

  • psg-prod-eastus.azureedge.net- CDN ana bilgisayar adı
  • az818661.vo.msecnd.net- CDN ana bilgisayar adı
  • devopsgallerystorage.blob.core.windows.net - depolama hesabı ana bilgisayar adı
  • *.powershellgallery.com - web sitesi
  • go.microsoft.com - yeniden yönlendirme hizmeti

Bu ana bilgisayar adlarına ağınız üzerinden erişimi kontrol sağlayan izin verme listelerine eklenmiştir.

Önemli

2020 Nisan itibariyle PowerShell Galerisi artık Aktarım Katmanı Güvenliği (TLS) 1,0 ve 1,1 sürümlerini desteklememektedir. TLS 1,2 veya üstünü 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 blogdaki duyuruya bakın.