Partilhar via

Find-RoleCapability

  • Referência
Módulo:
PowerShellGet

Localiza capacidades de função em módulos.

Syntax

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 procura repositórios registados para encontrar capacidades e módulos de função do PowerShell.

Para cada capacidade de função encontrada pelo Find-RoleCapability, é devolvido um objeto PSGetRoleCapabilityInfo . Os objetos PSGetRoleCapabilityInfo podem ser enviados pelo pipeline para os Install-Module cmdlets ouSave-Module.

As capacidades de função do PowerShell definem que comandos e aplicações estão disponíveis para um utilizador num ponto final de Administração Just Enough (JEA). As capacidades de função são definidas por ficheiros com uma .psrc extensão.

Exemplos

Exemplo 1: Localizar capacidades de função

Find-RoleCapability localiza as capacidades de função em cada repositório registado. Para procurar um repositório específico, utilize 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 capacidades de função por nome

Find-RoleCapability localiza capacidades de função por nome. Utilize 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 guardar o módulo de uma capacidade de função

O Find-RoleCapability cmdlet encontra uma capacidade de função e envia o objeto pelo pipeline. Save-Module guarda o módulo da capacidade de função num sistema de ficheiros. Get-ChildItem apresenta 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 utiliza o parâmetro Nome para especificar a capacidade de função General-Lev1 . O objeto é enviado pelo pipeline. Save-Module utiliza o parâmetro Caminho para a localização do sistema de ficheiros para guardar o módulo. Depois de o módulo ser guardado, Get-ChildItem especifica o Caminho do módulo e apresenta os conteúdos do diretório do módulo JeaExamples .

Exemplo 4: localizar e instalar o módulo de uma capacidade 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, utilize 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 utiliza o parâmetro Nome para especificar a capacidade de função General-Lev1 . O objeto é enviado pelo pipeline. Install-Module utiliza o parâmetro Verboso para apresentar mensagens de estado 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.

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

-AllVersions

Indica que este cmdlet obtém todas as versões de um módulo. O parâmetro AllVersions apresenta cada uma das versões disponíveis de um módulo.

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

-Filter

Localiza recursos com base na sintaxe de pesquisa do fornecedor PackageManagement . Por exemplo, especifique as palavras a procurar nas propriedades ModuleName e Description .

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

-MaximumVersion

Especifica a versão máxima do módulo a incluir nos resultados. Os parâmetros MaximumVersion e RequiredVersion não podem ser utilizados no mesmo comando.

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

-MinimumVersion

Especifica a versão mínima do módulo a incluir nos resultados. Os parâmetros MinimumVersion e RequiredVersion não podem ser utilizados no mesmo comando.

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

-ModuleName

Especifica o nome do módulo no qual pretende procurar capacidades de função. A predefinição é todos os módulos.

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

-Name

Especifica o nome de uma capacidade de função. A predefinição é todas as capacidades de função. Utilize vírgulas para separar uma matriz de nomes de recursos.

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

-Proxy

Especifica um servidor proxy para o pedido, em vez de uma ligação direta ao recurso da Internet.

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

-ProxyCredential

Especifica uma conta de utilizador com permissão para utilizar o servidor proxy especificado no parâmetro Proxy .

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

-Repository

Especifica um repositório para procurar capacidades de função. Utilize vírgulas para separar uma matriz de nomes de repositórios.

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

-RequiredVersion

Especifica o número de versão exato do módulo a incluir nos resultados. Os parâmetros RequiredVersion e MinimumVersion não podem ser utilizados no mesmo comando.

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

-Tag

Especifica etiquetas que categorizam módulos num repositório. Utilize vírgulas para separar uma matriz de etiquetas.

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

Entradas

Uri

PSCredential

Saídas

PSGetRoleCapabilityInfo

O Find-RoleCapability cmdlet devolve um objeto PSGetRoleCapabilityInfo .

Notas

Importante

A partir de abril de 2020, o Galeria do PowerShell já não suporta as versões 1.0 e 1.1 do Transport Layer Security (TLS). Se não estiver a utilizar o TLS 1.2 ou superior, receberá um erro ao tentar aceder ao Galeria do PowerShell. Utilize o seguinte comando para garantir que está a utilizar o TLS 1.2:

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

Para obter mais informações, veja o anúncio no blogue do PowerShell.