Share via

about_PSResourceGet

  • Makale

Kısa açıklama

Microsoft.PowerShell.PSResourceGet modülünün 1.0.5 sürümünün nasıl kullanılacağını açıklar.

Uzun açıklama

Microsoft.PowerShell.PSResourceGet, PowerShellGet modülünün tamamen C# dilinde yazılmış güncelleştirilmiş bir sürümüdür.

PowerShellGet'in bu sürümü birkaç önemli alana odaklanır:

  • Hataları geliştirmeyi ve düzeltmeyi kolaylaştırmak için kod tabanını basitleştirin
  • PackageManagement modülündeki bağımlılığı kaldırın ve nuget kitaplığını doğrudan kullanın
  • v2'den gelen değişiklikleri bozacak uzun süredir devam eden kullanılabilirlik sorunlarını giderme
  • Ayrı bir uyumluluk modülü aracılığıyla v2 bekleniyorken yazılmış mevcut betikler için uyumluluğu koruma
  • Arama ve yükleme performansını geliştirme

Tasarım değişiklikleri

PowerShellGet'in önceki sürümlerinde modüller ve betiklerle çalışmak için ayrı komutlar vardı. Microsoft.PowerShell.PSResourceGet'te, PowerShell Galerisi içindeki tüm paketler PSResource nesneleri olarak tanımlanır. Bu, 2.x sürümünde 26 olan cmdlet'lerin sayısını sürüm 0.9'da 18'e düşürür.

Aşağıdaki tabloda PowerShellGet v3 ve bunların v2 eşdeğerlerinde kullanılabilen cmdlet'ler gösterilmektedir.

Microsoft.PowerShell.PSResourceGet PowerShellGet v2
Find-PSResource Find-Command
Find-PSResource Find-DscResource
Find-PSResource Find-Module
Find-PSResource Find-Script
yok Find-RoleCapability
Get-InstalledPSResource Get-InstalledModule
Get-InstalledPSResource Get-InstalledScript
Get-PSResourceRepository Get-PSRepository
Get-PSScriptFileInfo yok
Import-PSGetRepository yok
Install-PSResource Install-Module
Install-PSResource Install-Script
New-PSScriptFileInfo New-ScriptFileInfo
Publish-PSResource Publish-Module
Publish-PSResource Publish-Script
Register-PSResourceRepository Register-PSRepository
Save-PSResource Save-Module
Save-PSResource Save-Script
Set-PSResourceRepository Set-PSRepository
Test-PSScriptFileInfo Test-ScriptFileInfo
Uninstall-PSResource Uninstall-Module
Uninstall-PSResource Uninstall-Script
Unregister-PSResourceRepository Unregister-PSRepository
Update-PSModuleManifest Update-ModuleManifest
Update-PSResource Update-Module
Update-PSResource Update-Script
Update-PSScriptFileInfo Update-ScriptFileInfo

NuGet sürüm aralıklarına göre arama

Çeşitli Microsoft.PowerShell.PSResourceGet cmdlet'leri, aranacak sürüm aralığını belirtmenize olanak tanıyan bir Sürüm parametresi sağlar. Version parametresi NuGet sürüm oluşturma söz dizimini kullanır. NuGet sürüm aralıkları hakkında daha fazla bilgi için bkz . Paket sürümü oluşturma.

PowerShellGet, NuGet sürüm aralığı belgelerinde listelenen en düşük dahil sürüm dışında tüm sürümleri destekler. Sürüm olarak kullanmak 1.0.0.0 1.0.0.0 ve üzeri sürümleri (en düşük dahil aralık) vermez. Bunun yerine, değer gerekli sürüm olarak kabul edilir. En düşük kapsamlı aralığı aramak için sürüm aralığı olarak kullanın [1.0.0.0, ] .

Gerekli kaynaklara göre arama

Cmdlet'in Install-PSResource belirli ölçütlerle eşleşen PSResource nesnelerini bulmak için kullanılan RequiredResource ve RequiredResourceFile parametreleri vardır. Arama ölçütlerini bir karma tablo veya JSON nesnesi kullanarak belirtebilirsiniz. RequiredResourceFile parametresi için hashtable bir .psd1 dosyada depolanır ve JSON nesnesi bir .json dosyada depolanır.

Karma tablo birden çok modül için öznitelikler içerebilir. Aşağıdaki örnekte modül belirtiminin yapısı gösterilmektedir:

@{
    <modulename> = @{
        version = '<version-spcification>'
        repository = '<reponame>'
        prerelease = '<boolean>'
    }
}

Bu örnek üç modülün belirtimlerini içerir. Olabildiğince, modül öznitelikleri isteğe bağlıdır.

 @{
    TestModule = @{
        version = '[0.0.1,1.3.0]'
        repository = 'PSGallery'
    }

    TestModulePrerelease = @{
        version = '[0.0.0,0.0.5]'
        repository = 'PSGallery'
        prerelease = $true
    }

    TestModule99 = @{}
}

Sonraki örnekte JSON biçiminde aynı belirtim gösterilmektedir.

{
  "TestModule": {
    "version": "[0.0.1,1.3.0)",
    "repository": "PSGallery"
  },
  "TestModulePrerelease": {
    "version": "[0.0.0,0.0.5]",
    "repository": "PSGallery",
    "prerelease": "true"
  },
  "TestModule99": {}
}

Ayrıca bkz.