Get-CMSecurityRole

  • Referencia
Módulo:
ConfigurationManager

Obtener roles de seguridad.

Syntax

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 Configuration Manager, por ejemploPS 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.

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

-ForceWildcardHandling

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 .

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

-Name

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

Type:String
Aliases:RoleName
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.