Get-CMSecurityRole

  • Referência
Módulo:
ConfigurationManager

Obtenha funções de segurança.

Syntax

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

Description

Use este cmdlet para obter uma ou mais funções de segurança do site Configuration Manager. Para obter mais informações sobre funções de segurança e permissões, consulte Fundamentos da administração baseada em função em Configuration Manager.

Se sua conta não tiver permissões para exibir funções de segurança no site, esse cmdlet não retornará resultados.

Observação

Execute Configuration Manager cmdlets da unidade do site Configuration Manager, por exemplo PS XYZ:\>. Para obter mais informações, confira 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 usando um curinga

Esse comando obtém todas as funções de segurança que têm um nome que começa com App.

Get-CMSecurityRole -Name "App*"

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

Esse comando retorna todas as funções de segurança que não são internas.

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

Parâmetros

-DisableWildcardHandling

Esse parâmetro trata caracteres curinga como valores de caractere literal. Você não pode combiná-lo com ForceWildcardHandling.

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

-ForceWildcardHandling

Esse parâmetro processa caracteres curinga e pode levar a um comportamento inesperado (não recomendado). Você não pode combiná-lo com DisableWildcardHandling.

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

-Id

Especifique a ID da função de segurança a ser obtém. Esse valor é a RoleID propriedade, por exemplo SMS000AR , para a função gerenciador de implantação do sistema operacional .

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

-Name

Especifique o nome da função de segurança a ser obtém.

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

Entradas

None

Saídas

IResultObject[]

IResultObject

Observações

Para obter mais informações sobre esse objeto retornado e suas propriedades, consulte SMS_Role classe WMI do servidor.