Compartir a través de

Find-RoleCapability

  • Referencia
Módulo:
PowerShellGet

Busca funcionalidades de rol en 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

El Find-RoleCapability cmdlet busca repositorios registrados para buscar módulos y funcionalidades de rol de PowerShell.

Para cada funcionalidad de rol encontrada por Find-RoleCapability, se devuelve un objeto PSGetRoleCapabilityInfo . Los objetos PSGetRoleCapabilityInfo se pueden enviar por la canalización a los Install-Module cmdlets o Save-Module .

Las funcionalidades de rol de PowerShell definen qué comandos y aplicaciones están disponibles para un usuario en un punto de conexión de Just Enough Administration (JEA). Las funcionalidades de rol se definen mediante archivos con una .psrc extensión.

Ejemplos

Ejemplo 1: Búsqueda de funcionalidades de rol

Find-RoleCapability busca funcionalidades de rol en cada repositorio registrado. Para buscar en un repositorio específico, use el parámetro Repository .

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

Ejemplo 2: Búsqueda de funcionalidades de rol por nombre

Find-RoleCapability busca funcionalidades de rol por nombre. Use comas para separar una matriz de nombres.

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

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

Ejemplo 3: Buscar y guardar el módulo de una funcionalidad de rol

El Find-RoleCapability cmdlet busca una funcionalidad de rol y envía el objeto a la canalización. Save-Module guarda el módulo de la funcionalidad de rol en un sistema de archivos. Get-ChildItem muestra el contenido del directorio del 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 el parámetro Name para especificar la funcionalidad de rol General-Lev1 . El objeto se envía a la canalización. Save-Module usa el parámetro Path para la ubicación del sistema de archivos para guardar el módulo. Una vez guardado el módulo, Get-ChildItem especifica la ruta de acceso del módulo y muestra el contenido del directorio del módulo JeaExamples .

Ejemplo 4: Buscar e instalar el módulo de una funcionalidad de rol

Find-RoleCapability busca el módulo y envía el objeto a la canalización. Install-Module instala el módulo. Después de la instalación, use Get-InstalledModule para ver los 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 el parámetro Name para especificar la funcionalidad de rol General-Lev1 . El objeto se envía a la canalización. Install-Module usa el parámetro Verbose para mostrar los mensajes de estado durante la instalación. Una vez finalizada la instalación, la Get-InstalledModule salida confirma que se instaló el módulo JeaExamples .

Parámetros

-AllowPrerelease

Incluye recursos marcados como una versión preliminar en los resultados.

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

-AllVersions

Indica que este cmdlet obtiene todas las versiones de un módulo. El parámetro AllVersions muestra cada una de las versiones disponibles de un módulo.

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

-Filter

Busca recursos basados en la sintaxis de búsqueda del proveedor PackageManagement . Por ejemplo, especifique las palabras que se van a buscar en las propiedades ModuleName y Description .

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

-MaximumVersion

Especifica la versión máxima del módulo que se va a incluir en los resultados. Los parámetros MaximumVersion y RequiredVersion no se pueden usar en el mismo comando.

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

-MinimumVersion

Especifica la versión mínima del módulo que se va a incluir en los resultados. Los parámetros MinimumVersion y RequiredVersion no se pueden usar en el mismo comando.

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

-ModuleName

Especifica el nombre del módulo en el que se van a buscar funcionalidades de rol. El valor predeterminado es todos los módulos.

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

-Name

Especifica el nombre de una funcionalidad de rol. El valor predeterminado es todas las funcionalidades de rol. Use comas para separar una matriz de nombres de recursos.

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

-Proxy

Especifica un servidor proxy para la solicitud, en lugar de una conexión directa al recurso de Internet.

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

-ProxyCredential

Especifica una cuenta de usuario con permiso para usar el servidor proxy especificado en el parámetro Proxy .

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

-Repository

Especifica un repositorio para buscar funcionalidades de rol. Use comas para separar una matriz de nombres de repositorio.

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

-RequiredVersion

Especifica el número de versión exacto del módulo que se va a incluir en los resultados. Los parámetros RequiredVersion y MinimumVersion no se pueden usar en el mismo comando.

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

-Tag

Especifica etiquetas que clasifican módulos en un repositorio. Use comas para separar una matriz de etiquetas.

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

Entradas

Uri

PSCredential

Salidas

PSGetRoleCapabilityInfo

El Find-RoleCapability cmdlet devuelve un objeto PSGetRoleCapabilityInfo .

Notas

Importante

A partir de abril de 2020, Galería de PowerShell ya no es compatible con las versiones 1.0 y 1.1 de Seguridad de la capa de transporte (TLS). Si no usa TLS 1.2 o una versión posterior, recibirá un error al intentar obtener acceso a Galería de PowerShell. Use el siguiente comando para asegurarse de que usa TLS 1.2:

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

Para más información, consulte el anuncio en el blog de PowerShell.