about_PSResourceGet

Deskripsi singkat

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

Deskripsi panjang

Microsoft.PowerShell.PSResourceGet adalah versi terbaru dari modul PowerShellGet yang sepenuhnya ditulis dalam C# dan memberikan manfaat berikut dibandingkan versi PowerShellGet sebelumnya:

  • Menyederhanakan basis kode sehingga lebih mudah untuk menyempurnakan dan memperbaiki bug
  • Menghapus dependensi pada modul PackageManagement dan menggunakan API NuGet secara langsung
  • Mengatasi masalah kegunaan lama yang akan merusak perubahan jika dibuat di PowerShellGet v2
  • Meningkatkan performa pencarian dan penginstalan

Pertama kali Anda menggunakan Microsoft.PowerShell.PSResourceGet, modul mendaftarkan Galeri PowerShell sebagai repositori PSResource. Secara default, repositori PSGallery terdaftar dengan prioritas 50 dan ditandai sebagai tidak tepercaya. Gunakan perintah berikut untuk memercayai repositori PSGallery:

Set-PSResourceRepository -Name PSGallery -Trusted -PassThru

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.

Tabel berikut menunjukkan cmdlet yang tersedia di Microsoft.PowerShell.PSResourceGet dan padanan PowerShellGet v2-nya.

Microsoft.PowerShell.PSResourceGet PowerShellDapatkan v2
Compress-PSResource N/a
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
Reset-PSResourceRepository N/a
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 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). Sebagai gantinya, 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

Cmdlet memiliki RequiredResource dan parameter 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 file dan objek JSON disimpan dalam 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

  • Install-PSResource
  • Find-PSResource
  • Get-InstallPSResource
  • Install-PSResource
  • Save-PSResource
  • Uninstall-PSResource
  • Update-PSResource
  • Last updated on