Compartilhar via

Get-CMSecurityRole

  • Referência
Módulo:
ConfigurationManager

Obter funções de segurança.

Sintaxe

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

Description

Utilize este cmdlet para obter uma ou mais funções de segurança do site do Configuration Manager. Para obter mais informações sobre funções e permissões de segurança, veja Noções básicas da administração baseada em funções no Configuration Manager.

Se a sua conta não tiver permissões para ver funções de segurança no site, este cmdlet não devolve resultados.

Observação

Execute cmdlets do Configuration Manager a partir da unidade do site do Configuration Manager, por exemplo PS XYZ:\>. Para obter mais informações, veja Introdução.

Exemplos

Exemplo 1: Obter todas as funções de segurança

Este exemplo lista todas as funções e IDs do site.

Get-CMSecurityRole | Select-Object RoleID, RoleName

Exemplo 2: Obter uma função de segurança com um caráter universal

Este comando obtém todas as funções de segurança que têm um nome que começa com Aplicação.

Get-CMSecurityRole -Name "App*"

Exemplo 3: Listar todas as funções de segurança personalizadas

Este comando devolve todas as funções de segurança que não estão incorporadas.

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

Parâmetros

-DisableWildcardHandling

Este parâmetro trata os carateres universais como valores de carateres literais. Não pode combiná-lo com ForceWildcardHandling.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ForceWildcardHandling

Este parâmetro processa carateres universais e pode levar a um comportamento inesperado (não recomendado). Não pode combiná-lo com DisableWildcardHandling.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Id

Especifique o ID da função de segurança a obter. Este valor é a RoleID propriedade, por exemplo SMS000AR , para a função Gestor de Implementação do SO .

Tipo:String
Aliases:RoleId
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Name

Especifique o nome da função de segurança a obter.

Tipo:String
Aliases:RoleName
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:True

Entradas

None

Saídas

IResultObject[]

IResultObject

Observações

Para obter mais informações sobre este objeto de retorno e as respetivas propriedades, veja SMS_Role classe WMI de servidor.