Compartir a través de

Get-CMSecurityRole

  • Referencia
Módulo:
ConfigurationManager

Obtener roles de seguridad.

Sintaxis

Get-CMSecurityRole
   [-Name <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
Get-CMSecurityRole
   -Id <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

Description

Use este cmdlet para obtener uno o varios roles de seguridad del sitio de Configuration Manager. Para obtener más información sobre los roles de seguridad y los permisos, consulte Aspectos básicos de la administración basada en roles en Configuration Manager.

Si la cuenta no tiene permisos para ver los roles de seguridad en el sitio, este cmdlet no devuelve ningún resultado.

Nota:

Ejecute cmdlets de Configuration Manager desde la unidad de sitio de Configuration Manager, por ejemplo PS XYZ:\>. Para obtener más información, consulte Introducción.

Ejemplos

Ejemplo 1: Obtención de todos los roles de seguridad

En este ejemplo se enumeran todos los roles e identificadores del sitio.

Get-CMSecurityRole | Select-Object RoleID, RoleName

Ejemplo 2: Obtención de un rol de seguridad mediante un carácter comodín

Este comando obtiene todos los roles de seguridad que tienen un nombre que comienza por App.

Get-CMSecurityRole -Name "App*"

Ejemplo 3: Enumerar todos los roles de seguridad personalizados

Este comando devuelve todos los roles de seguridad que no están integrados.

Get-CMSecurityRole | Where-Object { $_.IsBuiltIn -eq $false }

Parámetros

-DisableWildcardHandling

Este parámetro trata los caracteres comodín como valores de caracteres literales. No se puede combinar con ForceWildcardHandling.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ForceWildcardHandling

Este parámetro procesa caracteres comodín y puede provocar un comportamiento inesperado (no recomendado). No se puede combinar con DisableWildcardHandling.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Id

Especifique el identificador del rol de seguridad que se va a obtener. Este valor es la RoleID propiedad , por ejemplo SMS000AR , para el rol administrador de implementación del sistema operativo .

Tipo:String
Alias:RoleId
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Name

Especifique el nombre del rol de seguridad que se va a obtener.

Tipo:String
Alias:RoleName
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:True

Entradas

None

Salidas

IResultObject[]

IResultObject

Notas

Para obtener más información sobre este objeto devuelto y sus propiedades, vea SMS_Role clase WMI de servidor.