Partekatu honen bidez:

Find-RoleCapability

Módulo:
PowerShellGet Module

Busca funcionalidades de rol en módulos.

Sintaxis

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

El Find-RoleCapability cmdlet busca repositorios registrados para buscar funcionalidades y módulos 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 Just Enough Administration (JEA). Las funcionalidades de rol se definen mediante archivos con una .psrc extensión.

Ejemplos

Ejemplo 1: Buscar 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 de .

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 los recursos marcados como una versión preliminar en los resultados.

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes: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.

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Filter

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

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-MaximumVersion

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

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-MinimumVersion

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

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes: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.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes: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.

Propiedades de parámetro

Tipo:

String[]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:0
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Proxy

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

Propiedades de parámetro

Tipo:Uri
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-ProxyCredential

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

Propiedades de parámetro

Tipo:PSCredential
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-Repository

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

Propiedades de parámetro

Tipo:

String[]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-RequiredVersion

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

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Tag

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

Propiedades de parámetro

Tipo:

String[]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

CommonParameters

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.

Entradas

Uri

PSCredential

Salidas

PSGetRoleCapabilityInfo

El Find-RoleCapability cmdlet devuelve un objeto PSGetRoleCapabilityInfo .

Notas

Importante

A partir de abril de 2020, la Galería de PowerShell ya no admite las versiones 1.0 y 1.1 de seguridad de la capa de transporte (TLS). Si no usa TLS 1.2 o superior, recibirá un error al intentar acceder a la Galería de PowerShell. Use el comando siguiente para asegurarse de que usa TLS 1.2:

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

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