Find-RoleCapability
Menemukan kemampuan peran dalam modul.
Sintaks
All
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 didefinisikan 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: Temukan 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 konten 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.
Properti parameter
| Jenis: | SwitchParameter |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
Kumpulan parameter
(All)
| Position: | Named |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | False |
| Nilai dari argumen yang tersisa: | False |
-AllVersions
Menunjukkan bahwa cmdlet ini mendapatkan semua versi modul. Parameter AllVersions menampilkan setiap versi modul yang tersedia.
Properti parameter
| Jenis: | SwitchParameter |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
Kumpulan parameter
(All)
| Position: | Named |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | False |
| Nilai dari argumen yang tersisa: | False |
-Filter
Menemukan sumber daya berdasarkan sintaks pencarian PackageManagement penyedia. Misalnya, tentukan kata yang akan dicari dalam ModuleName
Properti parameter
| Jenis: | String |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
Kumpulan parameter
(All)
| Position: | Named |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | False |
| Nilai dari argumen yang tersisa: | False |
-MaximumVersion
Menentukan versi maksimum modul untuk disertakan dalam hasil. MaximumVersion dan parameter RequiredVersion tidak dapat digunakan dalam perintah yang sama.
Properti parameter
| Jenis: | String |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
Kumpulan parameter
(All)
| Position: | Named |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | False |
| Nilai dari argumen yang tersisa: | False |
-MinimumVersion
Menentukan versi minimum modul untuk disertakan dalam hasil. Parameter MinimumVersion dan RequiredVersion tidak dapat digunakan dalam perintah yang sama.
Properti parameter
| Jenis: | String |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
Kumpulan parameter
(All)
| Position: | Named |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | False |
| Nilai dari argumen yang tersisa: | False |
-ModuleName
Menentukan nama modul untuk mencari kemampuan peran. Defaultnya adalah semua modul.
Properti parameter
| Jenis: | String |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
Kumpulan parameter
(All)
| Position: | Named |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | False |
| Nilai dari argumen yang tersisa: | False |
-Name
Menentukan nama kemampuan peran. Defaultnya adalah semua kemampuan peran. Gunakan koma untuk memisahkan array nama sumber daya.
Properti parameter
| Jenis: | String[] |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
Kumpulan parameter
(All)
| Position: | 0 |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | False |
| Nilai dari argumen yang tersisa: | False |
-Proxy
Menentukan server proksi untuk permintaan, bukan koneksi langsung ke sumber daya internet.
Properti parameter
| Jenis: | Uri |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
Kumpulan parameter
(All)
| Position: | Named |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | True |
| Nilai dari argumen yang tersisa: | False |
-ProxyCredential
Menentukan akun pengguna dengan izin untuk menggunakan server proksi yang ditentukan dalam parameter Proksi .
Properti parameter
| Jenis: | PSCredential |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
Kumpulan parameter
(All)
| Position: | Named |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | True |
| Nilai dari argumen yang tersisa: | False |
-Repository
Menentukan repositori untuk mencari kemampuan peran. Gunakan koma untuk memisahkan array nama repositori.
Properti parameter
| Jenis: | String[] |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
Kumpulan parameter
(All)
| Position: | Named |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | False |
| Nilai dari argumen yang tersisa: | False |
-RequiredVersion
Menentukan nomor versi modul yang tepat untuk disertakan dalam hasilnya. parameter RequiredVersion dan MinimumVersion tidak dapat digunakan dalam perintah yang sama.
Properti parameter
| Jenis: | String |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
Kumpulan parameter
(All)
| Position: | Named |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | False |
| Nilai dari argumen yang tersisa: | False |
-Tag
Menentukan tag yang mengategorikan modul dalam repositori. Gunakan koma untuk memisahkan array tag.
Properti parameter
| Jenis: | String[] |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
Kumpulan parameter
(All)
| Position: | Named |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | False |
| Nilai dari argumen yang tersisa: | False |
CommonParameters
Cmdlet ini mendukung parameter umum: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, dan -WarningVariable. Untuk informasi selengkapnya, lihat about_CommonParameters.
Input
Uri
PSCredential
Output
PSGetRoleCapabilityInfo
Find-RoleCapability Cmdlet mengembalikan objek PSGetRoleCapabilityInfo.
Catatan
Penting
Pada April 2020, Galeri PowerShell 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
