about_PSResourceGet

Makale
10/31/2024

Kısa açıklama

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

Uzun açıklama

Microsoft.PowerShell.PSResourceGet, tamamen C# dilinde yazılmış PowerShellGet modülünün 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 doğrudan NuGet kitaplığını 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 önceki sürümlerinde modüller ve betiklerle çalışmak için ayrı komutlar vardı. Microsoft.PowerShell.PSResourceGetiçinde, PowerShell Galerisi'ndeki tüm paketler PSResource nesneleri olarak tanımlanı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
`Compress-PSResource`	Yok
`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 bir sürüm aralığı belirtmenize olanak tanıyan bir Sürüm parametresi sağlar. Sürüm 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 hariç tüm sürümleri destekler. sürüm olarak 1.0.0.0 kullanılması 1.0.0.0 ve üzeri sürümleri (en düşük kapsayıcı aralık) vermez. Bunun yerine, değer gerekli sürüm olarak kabul edilir. En düşük kapsayıcı aralığı aramak için sürüm aralığı olarak [1.0.0.0, ] kullanın.

Gerekli kaynaklara göre arama

cmdlet'i, belirli ölçütlerle eşleşen PSResource nesnelerini bulmak için kullanılan RequiredResource ve RequiredResourceFile parametrelerine sahiptir. Arama ölçütlerini bir karma tablo veya JSON nesnesi kullanarak belirtebilirsiniz. RequiredResourceFile parametresi için karma tablo bir .psd1 dosyasında ve JSON nesnesi .json bir 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.

Install-PSResource
Find-PSResource
Get-InstalledPSResource
Install-PSResource
Save-PSResource
Uninstall-PSResource
Update-PSResource

Aracılığıyla paylaş