Find-RoleCapability

Menemukan kemampuan peran dalam modul.

Sintaks

Find-RoleCapability
    [[-Name] <String[]>]
    [-ModuleName <String>]
    [-MinimumVersion <String>]
    [-MaximumVersion <String>]
    [-RequiredVersion <String>]
    [-AllVersions]
    [-AllowPrerelease]
    [-Tag <String[]>]
    [-Filter <String>]
    [-Proxy <Uri>]
    [-ProxyCredential <PSCredential>]
    [-Repository <String[]>]
    [<CommonParameters>]

Deskripsi

Find-RoleCapability Cmdlet mencari repositori terdaftar untuk menemukan kemampuan dan modul peran PowerShell.

Untuk setiap kemampuan peran yang ditemukan oleh Find-RoleCapability, objek PSGetRoleCapabilityInfo dikembalikan. Objek PSGetRoleCapabilityInfo dapat dikirimkan alur ke Install-Module cmdlet atau Save-Module .

Kemampuan peran PowerShell menentukan perintah dan aplikasi mana yang tersedia untuk pengguna di titik akhir Just Enough Administration (JEA). Kemampuan peran ditentukan oleh file dengan .psrc ekstensi.

Contoh

Contoh 1: Menemukan kemampuan peran

Find-RoleCapability menemukan kemampuan peran di setiap repositori terdaftar. Untuk mencari repositori tertentu, gunakan parameter Repositori .

Find-RoleCapability

Name             Version    ModuleName     Repository
----             -------    ----------     ----------
General-Lev1     1.0        JeaExamples    PSGallery
General-Lev2     1.0        JeaExamples    PSGallery
IIS-Lev1         1.0        JeaExamples    PSGallery
IIS-Lev2         1.0        JeaExamples    PSGallery

Contoh 2: Menemukan kemampuan peran berdasarkan nama

Find-RoleCapability menemukan kemampuan peran berdasarkan nama. Gunakan koma untuk memisahkan array nama.

Find-RoleCapability -Name General-Lev1, IIS-Lev2

Name             Version    ModuleName     Repository
----             -------    ----------     ----------
General-Lev1     1.0        JeaExamples    PSGallery
IIS-Lev2         1.0        JeaExamples    PSGallery

Contoh 3: Menemukan dan menyimpan modul kemampuan peran

Find-RoleCapability Cmdlet menemukan kemampuan peran dan mengirim objek ke bawah alur. Save-Module menyimpan modul kemampuan peran ke sistem file. Get-ChildItem menampilkan isi direktori modul.

PS> Find-RoleCapability -Name General-Lev1 | Save-Module -Path C:\Test\Modules

PS> Get-ChildItem -Path C:\Test\Modules\JeaExamples\1.0\

    Directory: C:\Test\Modules\JeaExamples\1.0

Mode                LastWriteTime         Length Name
----                -------------         ------ ----
d-----          6/4/2019    16:37                RoleCapabilities
-a----          2/5/2019    18:46           1702 CreateRegisterPSSC.ps1
-a----          2/5/2019    18:46           7656 JeaExamples.psd1
-a----         10/1/2018    08:16            595 JeaExamples.psm1

Find-RoleCapability menggunakan parameter Nama untuk menentukan kemampuan peran General-Lev1 . Objek dikirim ke alur. Save-Module menggunakan parameter Jalur untuk lokasi sistem file untuk menyimpan modul. Setelah modul disimpan, Get-ChildItem menentukan Jalur modul dan menampilkan konten direktori modul JeaExamples .

Contoh 4: Menemukan dan menginstal modul kemampuan peran

Find-RoleCapability menemukan modul dan mengirim objek ke bawah alur. Install-Module menginstal modul. Setelah penginstalan, gunakan Get-InstalledModule untuk melihat hasilnya.

Find-RoleCapability -Name General-Lev1 | Install-Module -Verbose

VERBOSE: Downloading 'https://www.powershellgallery.com/api/v2/package/JeaExamples/1.0.0'.
VERBOSE: Completed downloading 'https://www.powershellgallery.com/api/v2/package/JeaExamples/1.0.0'.
VERBOSE: Completed downloading 'JeaExamples'.
VERBOSE: InstallPackageLocal' - name='JeaExamples', version='1.0',
VERBOSE: Validating the 'JeaExamples' module contents
VERBOSE: Test-ModuleManifest successfully validated the module manifest file
VERBOSE: Module 'JeaExamples' was installed successfully to path

Get-InstalledModule

Find-RoleCapability menggunakan parameter Nama untuk menentukan kemampuan peran General-Lev1 . Objek dikirim ke alur. Install-Module menggunakan parameter Verbose untuk menampilkan pesan status selama penginstalan. Setelah penginstalan selesai, Get-InstalledModule output mengonfirmasi bahwa modul JeaExamples diinstal.

Parameter

-AllowPrerelease

Menyertakan sumber daya yang ditandai sebagai prarilis dalam hasil.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-AllVersions

Menunjukkan bahwa cmdlet ini mendapatkan semua versi modul. Parameter AllVersions menampilkan setiap versi modul yang tersedia.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Filter

Menemukan sumber daya berdasarkan sintaks pencarian penyedia PackageManagement . Misalnya, tentukan kata yang akan dicari dalam properti ModuleName dan Description .

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-MaximumVersion

Menentukan versi maksimum modul untuk disertakan dalam hasil. Parameter MaximumVersion dan RequiredVersion tidak dapat digunakan dalam perintah yang sama.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-MinimumVersion

Menentukan versi minimum modul untuk disertakan dalam hasil. Parameter MinimumVersion dan RequiredVersion tidak dapat digunakan dalam perintah yang sama.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-ModuleName

Menentukan nama modul untuk mencari kemampuan peran. Defaultnya adalah semua modul.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Name

Menentukan nama kemampuan peran. Defaultnya adalah semua kemampuan peran. Gunakan koma untuk memisahkan array nama sumber daya.

Type:String[]
Position:0
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Proxy

Menentukan server proksi untuk permintaan, bukan koneksi langsung ke sumber daya internet.

Type:Uri
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-ProxyCredential

Menentukan akun pengguna dengan izin untuk menggunakan server proksi yang ditentukan dalam parameter Proksi .

Type:PSCredential
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-Repository

Menentukan repositori untuk mencari kemampuan peran. Gunakan koma untuk memisahkan array nama repositori.

Type:String[]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-RequiredVersion

Menentukan nomor versi modul yang tepat untuk disertakan dalam hasilnya. Parameter RequiredVersion dan MinimumVersion tidak dapat digunakan dalam perintah yang sama.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Tag

Menentukan tag yang mengategorikan modul dalam repositori. Gunakan koma untuk memisahkan array tag.

Type:String[]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

Input

Uri

PSCredential

Output

PSGetRoleCapabilityInfo

Find-RoleCapability Cmdlet mengembalikan objek PSGetRoleCapabilityInfo.

Catatan

Penting

Mulai April 2020, PowerShell Gallery tidak lagi mendukung Transport Layer Security (TLS) versi 1.0 dan 1.1. Jika Anda tidak menggunakan TLS 1.2 atau yang lebih tinggi, Anda akan menerima kesalahan saat mencoba mengakses Galeri PowerShell. Gunakan perintah berikut untuk memastikan Anda menggunakan TLS 1.2:

[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12

Untuk informasi selengkapnya, lihat pengumuman di blog PowerShell.