Find-RoleCapability
A modulok szerepkör-képességeinek keresése.
Syntax
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>]
Description
A Find-RoleCapability parancsmag regisztrált adattárakban keres a PowerShell-szerepkörök képességeinek és moduljainak megkereséséhez.
Minden egyes szerepkör-képességhez Find-RoleCapability objektumot ad vissza a rendszer.
A PSGetRoleCapabilityInfo-objektumok elküldhetők a folyamaton a Install-Module parancsmagoknak.Save-Module
A PowerShell szerepkör-képességei határozzák meg, hogy mely parancsok és alkalmazások érhetők el a felhasználók számára a Just Enough Administration (JEA) végponton. A szerepkör-képességeket bővítményt .psrc tartalmazó fájlok határozzák meg.
Példák
1. példa: Szerepkör-képességek keresése
Find-RoleCapability szerepkör-képességeket keres az egyes regisztrált adattárakban. Egy adott adattár kereséséhez használja az Adattár paramétert.
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
2. példa: Szerepkör-képességek keresése név szerint
Find-RoleCapability név alapján keresi meg a szerepkör-képességeket. Vesszővel elválaszthat egy névtömböt.
Find-RoleCapability -Name General-Lev1, IIS-Lev2
Name Version ModuleName Repository
---- ------- ---------- ----------
General-Lev1 1.0 JeaExamples PSGallery
IIS-Lev2 1.0 JeaExamples PSGallery
3. példa: Szerepkör-képesség moduljának megkeresése és mentése
A Find-RoleCapability parancsmag megkeres egy szerepkör-képességet, és elküldi az objektumot a folyamaton.
Save-Module A szerepkör-képesség modulját egy fájlrendszerbe menti.
Get-ChildItem megjeleníti a modul könyvtárának tartalmát.
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 A Név paraméter használatával adja meg a General-Lev1 szerepkör-képességet.
A rendszer elküldi az objektumot a folyamatnak.
Save-Module A modul mentéséhez használja a fájlrendszer helyének Elérési út paraméterét. A modul mentése után megadja a modul Get-ChildItem, és megjeleníti a JeaExamples modul könyvtárának tartalmát.
4. példa: Szerepkör-képesség moduljának megkeresése és telepítése
Find-RoleCapability megkeresi a modult, és elküldi az objektumot a folyamatnak.
Install-Module telepíti a modult. A telepítés után az eredmények megtekintéséhez használja Get-InstalledModule .
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 A Név paraméter használatával adja meg a General-Lev1 szerepkör-képességet.
A rendszer elküldi az objektumot a folyamatnak.
Install-Module a Részletes paraméter használatával jeleníti meg az állapotüzeneteket a telepítés során. A telepítés befejezése után a Get-InstalledModule kimenet megerősíti, hogy a JeaExamples modul telepítve van.
Paraméterek
-AllowPrerelease
Az eredményekben előzetesként megjelölt erőforrásokat tartalmaz.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-AllVersions
Azt jelzi, hogy ez a parancsmag egy modul összes verzióját lekéri. Az AllVersions paraméter megjeleníti egy modul elérhető verzióit.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-Filter
Megkeresi az erőforrásokat a PackageManagement szolgáltató keresési szintaxisa alapján. Adja meg például a ModuleName és a Description tulajdonságban keresni kívánt szavakat.
Paramétertulajdonságok
| Típus: | String |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-MaximumVersion
Meghatározza, hogy a modul maximális verziója szerepeljen az eredmények között. A MaximumVersion és a RequiredVersion paraméterek nem használhatók ugyanabban a parancsban.
Paramétertulajdonságok
| Típus: | String |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-MinimumVersion
Meghatározza a modul minimális verzióját, amely az eredményekbe belefoglalandó. A MinimumVersion és a RequiredVersion paraméterek nem használhatók ugyanabban a parancsban.
Paramétertulajdonságok
| Típus: | String |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-ModuleName
Megadja annak a modulnak a nevét, amelyben szerepkör-képességeket szeretne keresni. Az alapértelmezett beállítás az összes modul.
Paramétertulajdonságok
| Típus: | String |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-Name
Egy szerepkör-képesség nevét adja meg. Az alapértelmezett beállítás az összes szerepkör-képesség. Az erőforrásnevek tömbjének elválasztásához használjon vesszőket.
Paramétertulajdonságok
| Típus: | String[] |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | 0 |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-Proxy
A kéréshez proxykiszolgálót ad meg, nem pedig az internetes erőforráshoz való közvetlen kapcsolatot.
Paramétertulajdonságok
| Típus: | Uri |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | True |
| Fennmaradó argumentumokból származó érték: | False |
-ProxyCredential
Megadja a proxyparaméterben megadott proxykiszolgáló használatára vonatkozó engedéllyel rendelkező felhasználói fiókot.
Paramétertulajdonságok
| Típus: | PSCredential |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | True |
| Fennmaradó argumentumokból származó érték: | False |
-Repository
Egy tárházat ad meg a szerepkör-képességek kereséséhez. Az adattárnevek tömbjének elválasztásához használjon vesszőket.
Paramétertulajdonságok
| Típus: | String[] |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-RequiredVersion
Megadja a modul pontos verziószámát, amely szerepel az eredmények között. A RequiredVersion és a MinimumVersion paraméterek nem használhatók ugyanabban a parancsban.
Paramétertulajdonságok
| Típus: | String |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-Tag
Olyan címkéket ad meg, amelyek kategorizálják a modulokat egy adattárban. Címkék tömbjének elválasztásához használjon vesszőt.
Paramétertulajdonságok
| Típus: | String[] |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
CommonParameters
Ez a parancsmag a következő gyakori paramétereket támogatja: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction és -WarningVariable. További információért lásd about_CommonParameters.
Bevitelek
Uri
PSCredential
Kimenetek
PSGetRoleCapabilityInfo
A Find-RoleCapability parancsmag egy PSGetRoleCapabilityInfo objektumot ad vissza.
Jegyzetek
Fontos
2020 áprilisától a PowerShell-katalógus már nem támogatja a Transport Layer Security (TLS) 1.0-s és 1.1-es verzióját. Ha nem TLS 1.2 vagy újabb verziót használ, hibaüzenet jelenik meg a PowerShell-gyűjtemény elérésekor. A következő paranccsal győződjön meg arról, hogy a TLS 1.2-t használja:
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
További információ: közlemény a PowerShell blogjában.