Zoeken naar RoleCapabilityFind-RoleCapability

Hiermee zoekt rol mogelijkheden in modules.Finds role capabilities in modules.

BeschrijvingDescription

De cmdlet zoeken RoleCapability zoekt PowerShell rol mogelijkheden in modules.The Find-RoleCapability cmdlet finds PowerShell role capabilities in modules. Modules zoekt zoeken RoleCapability in geregistreerde opslagplaatsen.Find-RoleCapability searches modules in registered repositories. Voor de capaciteit van elke rol die deze cmdlet vindt, wordt een PSGetRoleCapabilityInfo-object.For each role capability that this cmdlet finds, it returns a PSGetRoleCapabilityInfo object. U kunt een PSGetRoleCapabilityInfo-object doorgeven aan de cmdlet Install-Module voor het installeren van de module met de mogelijkheid van de rol.You can pass a PSGetRoleCapabilityInfo object to the Install-Module cmdlet to install the module that contains the role capability. PowerShell rol mogelijkheden definiëren die opdrachten, toepassingen, enzovoort beschikbaar zijn voor een gebruiker op een eindpunt net genoeg Administration (JEA).PowerShell role capabilities define which commands, applications, and so on are available to a user at a Just Enough Administration (JEA) endpoint. Rol mogelijkheden worden gedefinieerd door de bestanden met de extensie .psrc.Role capabilities are defined by files with a .psrc extension.

  • Zoeken naar RoleCapability kunt filteren met Versieparameters: MinimumVersion, RequiredVersion, AllVersions.Find-RoleCapability can filter with version parameters: MinimumVersion, RequiredVersion, AllVersions.
    • Deze parameters elkaar wederzijds uit.These parameters are mutually exclusive.
    • Deze Versieparameters zijn alleen met de naam van de één module zonder eventuele jokertekens toegestaan.These version parameters are allowed only with the single module name without any wildcards.
    • Als de parameter RequiredVersion niet is opgegeven, retourneert zoeken RoleCapability de nieuwste versie van de module die gelijk is aan of groter is dan de opgegeven minimumversie of de nieuwste versie van de module als er geen minimum versie is opgegeven.If the RequiredVersion parameter is not specified, Find-RoleCapability returns the latest version of the module that is equal to or greater than the minimum version specified or the latest version of the module if no minimum version is specified.
    • Als de parameter RequiredVersion is opgegeven, retourneert zoeken RoleCapability alleen de versie van de module die exact overeenkomt met de opgegeven versie.If the RequiredVersion parameter is specified, Find-RoleCapability only returns the version of the module that exactly matches the specified version.
  • Zoeken naar RoleCapability kunt filteren op de metagegevens van de module met de - parameter van labelFind-RoleCapability can filter on module metadata with the -Tag parameter
  • Zoeken naar RoleCapability kunt filteren op zoektaal opslagplaats-specifieke met de - parameter Filter.Find-RoleCapability can filter on repository-specific search language with the -Filter parameter.
  • Zoeken naar RoleCapability kunt filteren op modules van alle of enkele van de geregistreerde opslagplaatsen.Find-RoleCapability can filter on modules from all or few of the registered repositories.

De syntaxis van cmdletCmdlet syntax

Get-Command -Name Find-RoleCapability -Module PowerShellGet -Syntax

Verwijzing naar het online help van cmdletCmdlet online help reference

Zoeken naar RoleCapabilityFind-RoleCapability

VoorbeeldopdrachtenExample commands


# Find a specific role capability
Find-RoleCapability -Name Maintenance

Name                                Version    ModuleName                          Repository
----                                -------    ----------                          ----------
Maintenance                         1.5.0      RoleCapModule                       PrivatePSGallery

# Find multiple role capabilities
Find-RoleCapability -Name MyJeaRole, Maintenance

# Find all available role capabilities from all registered repositories
Find-RoleCapability

# Find available role capabilities from few registered repositories
Find-RoleCapability -Repository PSGallery,PrivatePSGallery

# Find all role capabilities in a specified repository
Find-RoleCapability -Repository PSGallery

# Find a role capability defined in a specific module
Find-RoleCapability -Name Maintenance -ModuleName RoleCapModule

# Find role capabilities from all versions of a module
Find-RoleCapability -ModuleName RoleCapModule -AllVersions

# Find role capabilities with module name and MinimumVersion.
Find-RoleCapability -ModuleName RoleCapModule -MinimumVersion 1.1

# Find role capabilities with module name and exact version
Find-RoleCapability -ModuleName RoleCapModule -RequiredVersion 1.4.0

# Find role capabilities defined modules with -Filter based search. -Filter searches in description and module names
Find-RoleCapability -Filter Cookbook
Find-RoleCapability -Filter RBAC

# Find all role capabilities with tags Azure or DSC in module metadata
Find-RoleCapability -Tag Azure, DSC