Find-RoleCapabilityFind-RoleCapability

Localiza capacidades de função em módulos.Finds role capabilities in modules.

DescriçãoDescription

O cmdlet Find-RoleCapability localiza capacidades de função do PowerShell em módulos.The Find-RoleCapability cmdlet finds PowerShell role capabilities in modules. Find-RoleCapability faz pesquisas em módulos em repositórios registrados.Find-RoleCapability searches modules in registered repositories. Para cada capacidade de função localizada, esse cmdlet retorna um objeto PSGetRoleCapabilityInfo.For each role capability that this cmdlet finds, it returns a PSGetRoleCapabilityInfo object. Você pode passar um objeto PSGetRoleCapabilityInfo para o cmdlet Install-Module para instalar o módulo que contém a capacidade de função.You can pass a PSGetRoleCapabilityInfo object to the Install-Module cmdlet to install the module that contains the role capability. As capacidades de função do PowerShell definem quais comandos, aplicativos e assim por diante ficam disponíveis para um usuário em um ponto de extremidade do tipo JEA ("Administração Suficiente").PowerShell role capabilities define which commands, applications, and so on are available to a user at a Just Enough Administration (JEA) endpoint. As capacidades de função são definidas por arquivos com uma extensão .psrc.Role capabilities are defined by files with a .psrc extension.

  • Find-RoleCapability pode filtrar segundo os parâmetros de versão: MinimumVersion, RequiredVersion, AllVersions.Find-RoleCapability can filter with version parameters: MinimumVersion, RequiredVersion, AllVersions.
    • Esses parâmetros são mutuamente exclusivos.These parameters are mutually exclusive.
    • Esses parâmetros de versão são permitidos apenas com o nome exclusivo do módulo, sem curingas.These version parameters are allowed only with the single module name without any wildcards.
    • Se o parâmetro RequiredVersion não for especificado, Find-RoleCapability retorna a versão mais recente do módulo que for igual ou maior que a versão mínima especificada ou a versão mais recente do módulo se nenhuma versão mínima tiver sido especificada.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.
    • Se o parâmetro RequiredVersion for especificado, Find-RoleCapability retornará apenas a versão do módulo que corresponde exatamente à versão especificada.If the RequiredVersion parameter is specified, Find-RoleCapability only returns the version of the module that exactly matches the specified version.
  • Find-RoleCapability pode filtrar nos metadados do módulo com o parâmetro -TagFind-RoleCapability can filter on module metadata with the -Tag parameter
  • Find-RoleCapability pode filtrar na linguagem de pesquisa específica do repositório com o parâmetro -Filter.Find-RoleCapability can filter on repository-specific search language with the -Filter parameter.
  • Find-RoleCapability pode filtrar módulos de todos ou de alguns dos repositórios registrados.Find-RoleCapability can filter on modules from all or few of the registered repositories.

Sintaxe do cmdletCmdlet syntax

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

Referência da ajuda online sobre cmdletsCmdlet online help reference

Find-RoleCapabilityFind-RoleCapability

Comandos de exemploExample 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