Sdílet prostřednictvím

Find-RoleCapability

  • Reference
Modul:
PowerShellGet

Vyhledá funkce rolí v modulech.

Syntax

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á registrovaná úložiště a najde možnosti a moduly rolí PowerShellu.

Pro každou funkci role nalezenou nástrojem Find-RoleCapabilityse vrátí objekt PSGetRoleCapabilityInfo . Objekty PSGetRoleCapabilityInfo lze odesílat do rutin nebo Save-Module v kanáluInstall-Module.

Funkce rolí PowerShellu definují, které příkazy a aplikace jsou uživateli k dispozici v koncovém bodu Jea (Just Enough Administration). Možnosti rolí jsou definovány soubory s příponou .psrc .

Příklady

Příklad 1: Vyhledání možností rolí

Find-RoleCapability vyhledá možnosti rolí v každém registrovaném úložišti. Pokud chcete vyhledat 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í možností rolí podle názvu

Find-RoleCapability vyhledá funkce rolí 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 vyhledá schopnost role a odešle objekt do kanálu. Save-Module uloží modul funkce 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í funkce role General-Lev1 . Objekt se odešle do kanálu. Save-Module k uložení modulu použije parametr Path pro umístění systému souborů. Po uložení Get-ChildItem modulu určí cestu k modulu a zobrazí obsah adresáře modulu JeaExamples .

Příklad 4: Vyhledání a instalace modulu funkce role

Find-RoleCapability vyhledá modul a odešle objekt do kanálu. Install-Module nainstaluje modul. Po instalaci použijte Get-InstalledModule k zobrazení výsledků.

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í funkce role General-Lev1 . Objekt se odešle do kanálu. Install-Module používá parametr Verbose k zobrazení stavových zpráv během instalace. Po dokončení instalace výstup potvrdí, Get-InstalledModule že byl nainstalován modul JeaExamples .

Parametry

-AllowPrerelease

Zahrne do výsledků prostředky označené jako předběžné vydání.

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

-AllVersions

Označuje, že tato rutina získá všechny verze modulu. Parametr AllVersions zobrazí každou dostupnou verzi modulu.

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

-Filter

Vyhledá prostředky na základě syntaxe vyhledávání zprostředkovatele PackageManagement . Zadejte například slova, která chcete vyhledat ve vlastnostech ModuleName a Description .

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

-MaximumVersion

Určuje maximální verzi modulu, která se má zahrnout do výsledků. Parametry MaximumVersion a RequiredVersion nelze použít ve stejném příkazu.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

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

-ModuleName

Určuje název modulu, ve kterém se mají hledat funkce rolí. Výchozí hodnota jsou všechny moduly.

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

-Name

Určuje název funkce role. Ve výchozím nastavení jsou všechny možnosti rolí. Pole názvů prostředků oddělte čárkami.

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

-Proxy

Určuje proxy server pro požadavek, nikoli přímé připojení k internetovému prostředku.

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

-ProxyCredential

Určuje uživatelský účet s oprávněním k použití proxy serveru zadaného v parametru Proxy .

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

-Repository

Určuje úložiště pro vyhledávání funkcí rolí. K oddělení pole názvů úložišť použijte čárky.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

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

-Tag

Určuje značky, které kategorizují moduly v úložišti. K oddělení pole značek použijte čárky.

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

Vstupy

Uri

PSCredential

Výstupy

PSGetRoleCapabilityInfo

Rutina Find-RoleCapability vrátí objekt PSGetRoleCapabilityInfo .

Poznámky

Důležité

Od dubna 2020 už Galerie prostředí PowerShell 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 Galerie 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í na blogu o PowerShellu.