about_PSResourceGet

  • Artikel

Deskripsi singkat

Menjelaskan cara menggunakan modul Microsoft.PowerShell.PSResourceGet versi 1.0.3.

Deskripsi panjang

Microsoft.PowerShell.PSResourceGet adalah versi terbaru dari modul PowerShellGet yang sepenuhnya ditulis dalam C#.

Versi PowerShellGet ini berfokus pada beberapa area utama:

  • Menyederhanakan basis kode sehingga lebih mudah untuk meningkatkan dan memperbaiki bug
  • Hapus dependensi pada modul PackageManagement dan gunakan pustaka NuGet secara langsung
  • Mengatasi masalah kegunaan jangka panjang yang akan merusak perubahan dari v2
  • Pertahankan kompatibilitas untuk skrip yang ada yang ditulis yang mengharapkan v2 melalui modul kompatibilitas terpisah
  • Meningkatkan performa pencarian dan penginstalan

Perubahan desain

Versi PowerShellGet sebelumnya memiliki perintah terpisah untuk bekerja dengan modul dan skrip. Di Microsoft.PowerShell.PSResourceGet, semua paket di Galeri PowerShell didefinisikan sebagai objek PSResource . Ini mengurangi jumlah cmdlet dari 26 dalam versi 2.x menjadi 18 dalam versi 0.9.

Tabel berikut ini memperlihatkan cmdlet yang tersedia di PowerShellGet v3 dan setara v2-nya.

Microsoft.PowerShell.PSResourceGet PowerShellGet v2
Find-PSResource Find-Command
Find-PSResource Find-DscResource
Find-PSResource Find-Module
Find-PSResource Find-Script
n/a Find-RoleCapability
Get-InstalledPSResource Get-InstalledModule
Get-InstalledPSResource Get-InstalledScript
Get-PSResourceRepository Get-PSRepository
Get-PSScriptFileInfo n/a
Import-PSGetRepository n/a
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

Mencari berdasarkan rentang versi NuGet

Beberapa cmdlet Microsoft.PowerShell.PSResourceGet menyediakan parameter Versi yang memungkinkan Anda menentukan rentang versi yang akan dicari. Parameter Versi menggunakan sintaks penerapan versi NuGet. Untuk informasi selengkapnya tentang rentang versi NuGet, lihat Penerapan versi paket.

PowerShellGet mendukung semua kecuali versi inklusif minimum yang tercantum dalam dokumentasi rentang versi NuGet. Menggunakan 1.0.0.0 sebagai versi tidak menghasilkan versi 1.0.0.0 dan yang lebih tinggi (rentang inklusif minimum). Sebaliknya, nilai dianggap sebagai versi yang diperlukan. Untuk mencari rentang inklusif minimum, gunakan [1.0.0.0, ] sebagai rentang versi.

Mencari berdasarkan sumber daya yang diperlukan

Install-PSResource Cmdlet memiliki parameter RequiredResource dan RequiredResourceFile yang digunakan untuk menemukan objek PSResource yang cocok dengan kriteria tertentu. Anda dapat menentukan kriteria pencarian menggunakan hashtable atau objek JSON. Untuk parameter RequiredResourceFile , hashtable disimpan dalam .psd1 file dan objek JSON disimpan dalam .json file.

Hashtable dapat berisi atribut untuk beberapa modul. Contoh berikut menunjukkan struktur spesifikasi modul:

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

Contoh ini berisi spesifikasi untuk tiga modul. Seperti yang Anda bisa, atribut modul bersifat opsional.

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

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

    TestModule99 = @{}
}

Contoh berikutnya menunjukkan spesifikasi yang sama dalam format JSON.

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

Lihat juga