Find-RoleCapability
Najde funkce rolí v modulech.
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
Rutina Find-RoleCapability prohledá zaregistrovaná úložiště a vyhledá funkce a moduly role PowerShellu.
Pro každou funkci role nalezena Find-RoleCapabilityPSGetRoleCapabilityInfo objekt je vrácen. Objekty PSGetRoleCapabilityInfo lze odeslat do kanálu Install-Module nebo Save-Module rutinám.
Funkce rolí PowerShellu definují, které příkazy a aplikace jsou uživateli k dispozici v koncovém bodu JEA (Just Enough Administration). Funkce rolí jsou definovány soubory s příponou .psrc .
Příklady
Příklad 1: Vyhledání možností rolí
Find-RoleCapability najde funkce rolí v každém registrovaném úložišti. Pokud chcete prohledat konkrétní úložiště, použijte parametr Repository.
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
Příklad 2: Vyhledání schopností rolí podle názvu
Find-RoleCapability najde možnosti role podle názvu. K oddělení pole názvů použijte čárky.
Find-RoleCapability -Name General-Lev1, IIS-Lev2
Name Version ModuleName Repository
---- ------- ---------- ----------
General-Lev1 1.0 JeaExamples PSGallery
IIS-Lev2 1.0 JeaExamples PSGallery
Příklad 3: Vyhledání a uložení modulu funkce role
Rutina Find-RoleCapability najde schopnost role a odešle objekt dolů kanálu.
Save-Module uloží modul schopností role do systému souborů.
Get-ChildItem zobrazí obsah adresáře modulu.
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 používá parametr Name k určení schopnosti role General-Lev1 .
Objekt se odešle do kanálu.
Save-Module k uložení modulu používá parametr Path pro umístění systému souborů. Po uložení Get-ChildItem modulu určuje cestu modulu a zobrazí obsah adresáře modulu JeaExamples .
Příklad 4: Vyhledání a instalace modulu funkcí role
Find-RoleCapability vyhledá modul a odešle objekt do kanálu.
Install-Module modul nainstaluje. Po instalaci se výsledky zobrazí pomocí Get-InstalledModule příkazu.
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 používá parametr Name k určení schopnosti role General-Lev1 .
Objekt se odešle do kanálu.
Install-Module používá příkazový parametr k zobrazení stavových zpráv během instalace. Po dokončení instalace výstup potvrdí, Get-InstalledModule že se nainstaloval modul JeaExamples .
Parametry
-AllowPrerelease
Zahrne do výsledků prostředky označené jako předběžné verze.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-AllVersions
Označuje, že tato rutina získá všechny verze modulu. Parametr AllVersions zobrazuje všechny dostupné verze modulu.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-Filter
Vyhledá prostředky na základě syntaxe vyhledávání poskytovatele PackageManagement. Zadejte například slova, která se mají hledat v
Vlastnosti parametru
| Typ: | String |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-MaximumVersion
Určuje maximální verzi modulu, která se má zahrnout do výsledků. MaximumVersion a parametry RequiredVersion nelze použít ve stejném příkazu.
Vlastnosti parametru
| Typ: | String |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-MinimumVersion
Určuje minimální verzi modulu, která se má zahrnout do výsledků. Parametry MinimumVersion a RequiredVersion nelze použít ve stejném příkazu.
Vlastnosti parametru
| Typ: | String |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-ModuleName
Určuje název modulu, ve kterém se mají hledat možnosti rolí. Výchozí hodnota je všechny moduly.
Vlastnosti parametru
| Typ: | String |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-Name
Určuje název funkce role. Výchozí možností jsou všechny možnosti role. K oddělení pole názvů prostředků použijte čárky.
Vlastnosti parametru
| Typ: | String[] |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | 0 |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-Proxy
Určuje proxy server pro požadavek, nikoli přímé připojení k internetovému prostředku.
Vlastnosti parametru
| Typ: | Uri |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
-ProxyCredential
Určuje uživatelský účet s oprávněním k použití proxy serveru zadaného v parametru Proxy .
Vlastnosti parametru
| Typ: | PSCredential |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
-Repository
Určuje úložiště, které bude hledat možnosti role. K oddělení pole názvů úložišť použijte čárky.
Vlastnosti parametru
| Typ: | String[] |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-RequiredVersion
Určuje přesné číslo verze modulu, které se má zahrnout do výsledků. Parametry RequiredVersion a MinimumVersion nelze použít ve stejném příkazu.
Vlastnosti parametru
| Typ: | String |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-Tag
Určuje značky, které kategorizují moduly v úložišti. K oddělení pole značek použijte čárky.
Vlastnosti parametru
| Typ: | String[] |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
CommonParameters
Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.
Vstupy
Uri
PSCredential
Výstupy
PSGetRoleCapabilityInfo
Rutina Find-RoleCapability vrátí objekt PSGetRoleCapabilityInfo .
Poznámky
Důležité
Od dubna 2020 galerie Prostředí PowerShell už nepodporuje protokol TLS (Transport Layer Security) verze 1.0 a 1.1. Pokud nepoužíváte protokol TLS 1.2 nebo vyšší, při pokusu o přístup k galerii Prostředí PowerShell se zobrazí chyba. Pomocí následujícího příkazu se ujistěte, že používáte protokol TLS 1.2:
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
Další informace najdete v oznámení v blogu PowerShellu.