Find-RoleCapability
Localiza recursos de função em módulos.
Sintaxe
All
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
O Find-RoleCapability cmdlet pesquisa repositórios registrados para localizar os módulos e funcionalidades de função do PowerShell.
Para cada funcionalidade de função encontrada por Find-RoleCapability, um objeto PSGetRoleCapabilityInfo é retornado. Objetos PSGetRoleCapabilityInfo podem ser enviados pelo pipeline para os cmdlets ou Install-Module para os Save-Module cmdlets.
Os recursos de função do PowerShell definem quais comandos e aplicativos estão disponíveis para um usuário em um ponto de extremidade JEA (Administração Just Enough). Os recursos de função são definidos por arquivos com uma .psrc extensão.
Exemplos
Exemplo 1: localizar funcionalidades de função
Find-RoleCapability localiza recursos de função em cada repositório registrado. Para pesquisar um repositório específico, use o parâmetro Repositório.
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
Exemplo 2: Localizar funcionalidades de função por nome
Find-RoleCapability localiza recursos de função por nome. Use vírgulas para separar uma matriz de nomes.
Find-RoleCapability -Name General-Lev1, IIS-Lev2
Name Version ModuleName Repository
---- ------- ---------- ----------
General-Lev1 1.0 JeaExamples PSGallery
IIS-Lev2 1.0 JeaExamples PSGallery
Exemplo 3: localizar e salvar o módulo de uma funcionalidade de função
O Find-RoleCapability cmdlet localiza uma funcionalidade de função e envia o objeto pelo pipeline.
Save-Module salva o módulo da funcionalidade de função em um sistema de arquivos.
Get-ChildItem exibe o conteúdo do diretório do módulo.
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 usa o parâmetro Name para especificar a funcionalidade de função General-Lev1 .
O objeto é enviado pelo pipeline.
Save-Module usa o parâmetro Path para o local do sistema de arquivos para salvar o módulo. Depois que o módulo é salvo, Get-ChildItem especifica o Caminho do módulo e exibe o conteúdo do diretório do módulo JeaExamples .
Exemplo 4: localizar e instalar o módulo de uma funcionalidade de função
Find-RoleCapability localiza o módulo e envia o objeto pelo pipeline.
Install-Module instala o módulo. Após a instalação, use Get-InstalledModule para ver os resultados.
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 usa o parâmetro Name para especificar a funcionalidade de função General-Lev1 .
O objeto é enviado pelo pipeline.
Install-Module usa o parâmetro Verbose para exibir mensagens de status durante a instalação. Após a conclusão da instalação, a Get-InstalledModule saída confirma que o módulo JeaExamples foi instalado.
Parâmetros
-AllowPrerelease
Inclui recursos marcados como pré-lançamento nos resultados.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-AllVersions
Indica que esse cmdlet obtém todas as versões de um módulo. O parâmetro AllVersions exibe cada uma das versões disponíveis de um módulo.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Filter
Localiza recursos com base na sintaxe de pesquisa do PackageManagement provedor. Por exemplo, especifique palavras para pesquisar dentro das propriedades moduleName
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-MaximumVersion
Especifica a versão máxima do módulo a ser incluída nos resultados. O
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-MinimumVersion
Especifica a versão mínima do módulo a ser incluída nos resultados. Os parâmetros MinimumVersion e RequiredVersion não podem ser usados no mesmo comando.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-ModuleName
Especifica o nome do módulo no qual pesquisar recursos de função. O padrão é todos os módulos.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Name
Especifica o nome de uma funcionalidade de função. O padrão é todos os recursos de função. Use vírgulas para separar uma matriz de nomes de recursos.
Propriedades do parâmetro
| Tipo: | String[] |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 0 |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Proxy
Especifica um servidor proxy para a solicitação, em vez de uma conexão direta com o recurso de Internet.
Propriedades do parâmetro
| Tipo: | Uri |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-ProxyCredential
Especifica uma conta de usuário com permissão para usar o servidor proxy especificado no parâmetro Proxy .
Propriedades do parâmetro
| Tipo: | PSCredential |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-Repository
Especifica um repositório para pesquisar recursos de função. Use vírgulas para separar uma matriz de nomes de repositório.
Propriedades do parâmetro
| Tipo: | String[] |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-RequiredVersion
Especifica o número exato da versão do módulo a ser incluído nos resultados. Os parâmetros RequiredVersion e MinimumVersion não podem ser usados no mesmo comando.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Tag
Especifica marcas que categorizam módulos em um repositório. Use vírgulas para separar uma matriz de marcas.
Propriedades do parâmetro
| Tipo: | String[] |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.
Entradas
Uri
PSCredential
Saídas
PSGetRoleCapabilityInfo
O Find-RoleCapability cmdlet retorna um objeto PSGetRoleCapabilityInfo .
Observações
Importante
A partir de abril de 2020, a Galeria do PowerShell não dá mais suporte ao TLS (Transport Layer Security) versões 1.0 e 1.1. Se você não estiver usando o TLS 1.2 ou superior, receberá um erro ao tentar acessar a Galeria do PowerShell. Use o seguinte comando para garantir que você esteja usando o TLS 1.2:
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
Para obter mais informações, consulte o comunicado no blog do PowerShell.