Delen via

Find-RoleCapability

  • Referentie
Module:
PowerShellGet

Hiermee vindt u functiemogelijkheden in modules.

Syntaxis

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

De Find-RoleCapability cmdlet doorzoekt geregistreerde opslagplaatsen om mogelijkheden en modules voor PowerShell-rollen te vinden.

Voor elke functiemogelijkheid die is gevonden door Find-RoleCapability, wordt een PSGetRoleCapabilityInfo object geretourneerd. PSGetRoleCapabilityInfo objecten kunnen naar de Install-Module of Save-Module cmdlets worden verzonden.

PowerShell-rolmogelijkheden definiëren welke opdrachten en toepassingen beschikbaar zijn voor een gebruiker op een JEA-eindpunt (Just Enough Administration). Rolmogelijkheden worden gedefinieerd door bestanden met een .psrc-extensie.

Voorbeelden

Voorbeeld 1: Functiemogelijkheden zoeken

Find-RoleCapability vindt u functiemogelijkheden in elke geregistreerde opslagplaats. Als u een specifieke opslagplaats wilt doorzoeken, gebruikt u de parameter Opslagplaats.

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

Voorbeeld 2: Functiemogelijkheden zoeken op naam

Find-RoleCapability vindt functiemogelijkheden op naam. Gebruik komma's om een matrix met namen te scheiden.

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

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

Voorbeeld 3: de module van een functiefunctie zoeken en opslaan

Met de Find-RoleCapability-cmdlet wordt een functiefunctie gevonden en wordt het object in de pijplijn verzonden. Save-Module slaat de module van de functiefunctie op in een bestandssysteem. Get-ChildItem de inhoud van de map van de module weergeven.

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 gebruikt de parameter Name om de functiefunctie General-Lev1 op te geven. Het object wordt naar beneden verzonden in de pijplijn. Save-Module gebruikt de parameter Path voor de locatie van het bestandssysteem om de module op te slaan. Nadat de module is opgeslagen, geeft Get-ChildItem het Pad van de module op en wordt de inhoud van de map van de JeaExamples module weergegeven.

Voorbeeld 4: De module van een functiefunctie zoeken en installeren

Find-RoleCapability zoekt de module en verzendt het object omlaag in de pijplijn. Install-Module installeert de module. Na de installatie gebruikt u Get-InstalledModule om de resultaten te bekijken.

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 gebruikt de parameter Name om de functiefunctie General-Lev1 op te geven. Het object wordt naar beneden verzonden in de pijplijn. Install-Module gebruikt de parameter Uitgebreide om statusberichten weer te geven tijdens de installatie. Nadat de installatie is voltooid, bevestigt de Get-InstalledModule uitvoer dat de JeaExamples module is geïnstalleerd.

Parameters

-AllowPrerelease

Bevat resources die zijn gemarkeerd als een voorlopige versie in de resultaten.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-AllVersions

Geeft aan dat deze cmdlet alle versies van een module ophaalt. In de parameter AllVersions worden alle beschikbare versies van een module weergegeven.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Filter

Hiermee vindt u resources op basis van de zoeksyntaxis van de PackageManagement provider. Geef bijvoorbeeld woorden op waarnaar moet worden gezocht in de eigenschappen ModuleName en Description.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-MaximumVersion

Hiermee geeft u de maximale versie van de module op die moet worden opgenomen in resultaten. De MaximumVersion en de parameters RequiredVersion kunnen niet worden gebruikt in dezelfde opdracht.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-MinimumVersion

Hiermee geeft u de minimale versie van de module op die moet worden opgenomen in resultaten. De MinimumVersion en de parameters RequiredVersion kunnen niet worden gebruikt in dezelfde opdracht.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ModuleName

Hiermee geeft u de naam van de module waarin moet worden gezocht naar functiemogelijkheden. De standaardwaarde is alle modules.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Name

Hiermee geeft u de naam van een functiemogelijkheid. De standaardwaarde is alle functiemogelijkheden. Gebruik komma's om een matrix met resourcenamen te scheiden.

Type:String[]
Position:0
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Proxy

Hiermee geeft u een proxyserver voor de aanvraag, in plaats van een directe verbinding met de internetbron.

Type:Uri
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-ProxyCredential

Hiermee geeft u een gebruikersaccount met toestemming voor het gebruik van de proxyserver die is opgegeven in de proxy parameter.

Type:PSCredential
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Repository

Hiermee geeft u een opslagplaats om te zoeken naar functiemogelijkheden. Gebruik komma's om een matrix met namen van opslagplaatsen te scheiden.

Type:String[]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-RequiredVersion

Hiermee geeft u het exacte versienummer van de module op dat in de resultaten moet worden opgenomen. De RequiredVersion en de parameters MinimumVersion kunnen niet worden gebruikt in dezelfde opdracht.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Tag

Hiermee geeft u tags op die modules in een opslagplaats categoriseren. Gebruik komma's om een matrix met tags te scheiden.

Type:String[]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Invoerwaarden

Uri

PSCredential

Uitvoerwaarden

PSGetRoleCapabilityInfo

De Find-RoleCapability cmdlet retourneert een PSGetRoleCapabilityInfo object.

Notities

Belangrijk

Vanaf april 2020 biedt de PowerShell Gallery geen ondersteuning meer voor TLS-versies (Transport Layer Security) 1.0 en 1.1. Als u TLS 1.2 of hoger niet gebruikt, krijgt u een foutmelding wanneer u toegang probeert te krijgen tot de PowerShell Gallery. Gebruik de volgende opdracht om ervoor te zorgen dat u TLS 1.2 gebruikt:

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

Zie de aankondiging in de PowerShell-blog voor meer informatie.