Udostępnij za pośrednictwem

Find-RoleCapability

  • Odwołanie
Moduł:
PowerShellGet

Znajduje funkcje roli w modułach.

Składnia

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>]

Opis

Polecenie Find-RoleCapability cmdlet wyszukuje zarejestrowane repozytoria, aby znaleźć możliwości i moduły roli programu PowerShell.

Dla każdej funkcji roli znalezionej przez Find-RoleCapabilityelement zwracany jest obiekt PSGetRoleCapabilityInfo . Obiekty PSGetRoleCapabilityInfo można wysłać w dół potoku do Install-Module poleceń cmdlet lubSave-Module.

Możliwości ról programu PowerShell definiują, które polecenia i aplikacje są dostępne dla użytkownika w punkcie końcowym Just Enough Administration (JEA). Funkcje roli są definiowane przez pliki z .psrc rozszerzeniem.

Przykłady

Przykład 1. Znajdowanie możliwości roli

Find-RoleCapability odnajduje funkcje roli w każdym zarejestrowanym repozytorium. Aby wyszukać określone repozytorium, użyj parametru Repozytorium .

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

Przykład 2. Znajdowanie możliwości roli według nazwy

Find-RoleCapability odnajduje możliwości roli według nazwy. Użyj przecinków, aby oddzielić tablicę nazw.

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

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

Przykład 3. Znajdowanie i zapisywanie modułu funkcji roli

Polecenie Find-RoleCapability cmdlet znajduje funkcję roli i wysyła obiekt w dół potoku. Save-Module Zapisuje moduł funkcji roli w systemie plików. Get-ChildItem wyświetla zawartość katalogu modułu.

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 używa parametru Name , aby określić funkcję roli General-Lev1 . Obiekt jest wysyłany w dół potoku. Save-Module używa parametru Path dla lokalizacji systemu plików w celu zapisania modułu. Po zapisaniu Get-ChildItem modułu określa ścieżkę modułu i wyświetla zawartość katalogu modułu JeaExamples .

Przykład 4. Znajdowanie i instalowanie modułu funkcji roli

Find-RoleCapability znajduje moduł i wysyła obiekt w dół potoku. Install-Module instaluje moduł. Po zakończeniu instalacji użyj polecenia Get-InstalledModule , aby wyświetlić wyniki.

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 używa parametru Name , aby określić funkcję roli General-Lev1 . Obiekt jest wysyłany w dół potoku. Install-Module używa parametru Verbose do wyświetlania komunikatów o stanie podczas instalacji. Po zakończeniu Get-InstalledModule instalacji dane wyjściowe potwierdzają, że moduł JeaExamples został zainstalowany.

Parametry

-AllowPrerelease

Zawiera zasoby oznaczone jako wersję wstępną w wynikach.

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

-AllVersions

Wskazuje, że to polecenie cmdlet pobiera wszystkie wersje modułu. Parametr AllVersions wyświetla każdą z dostępnych wersji modułu.

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

-Filter

Znajduje zasoby na podstawie składni wyszukiwania dostawcy PackageManagement . Na przykład określ wyrazy, które mają być wyszukiwane we właściwościach ModuleName i Description .

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

-MaximumVersion

Określa maksymalną wersję modułu do uwzględnienia w wynikach. Parametrów MaximumVersion i RequiredVersion nie można użyć w tym samym poleceniu.

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

-MinimumVersion

Określa minimalną wersję modułu do uwzględnienia w wynikach. Parametrów MinimumVersion i RequiredVersion nie można użyć w tym samym poleceniu.

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

-ModuleName

Określa nazwę modułu, w którym mają być wyszukiwane możliwości roli. Wartość domyślna to wszystkie moduły.

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

-Name

Określa nazwę funkcji roli. Wartość domyślna to wszystkie funkcje roli. Użyj przecinków, aby oddzielić tablicę nazw zasobów.

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

-Proxy

Określa serwer proxy dla żądania, a nie bezpośrednie połączenie z zasobem internetowym.

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

-ProxyCredential

Określa konto użytkownika z uprawnieniami do używania serwera proxy określonego w parametrze serwera proxy .

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

-Repository

Określa repozytorium do wyszukiwania możliwości roli. Użyj przecinków, aby oddzielić tablicę nazw repozytoriów.

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

-RequiredVersion

Określa dokładny numer wersji modułu do uwzględnienia w wynikach. Parametrów RequiredVersion i MinimumVersion nie można użyć w tym samym poleceniu.

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

-Tag

Określa tagi, które kategoryzują moduły w repozytorium. Użyj przecinków, aby oddzielić tablicę tagów.

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

Dane wejściowe

Uri

PSCredential

Dane wyjściowe

PSGetRoleCapabilityInfo

Polecenie Find-RoleCapability cmdlet zwraca obiekt PSGetRoleCapabilityInfo .

Uwagi

Ważne

Od kwietnia 2020 r. Galeria programu PowerShell nie obsługuje już protokołu Transport Layer Security (TLS) w wersji 1.0 i 1.1. Jeśli nie używasz protokołu TLS 1.2 lub nowszego, podczas próby uzyskania dostępu do Galeria programu PowerShell zostanie wyświetlony błąd. Użyj następującego polecenia, aby upewnić się, że używasz protokołu TLS 1.2:

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

Aby uzyskać więcej informacji, zobacz ogłoszenie w blogu programu PowerShell.