Share via


Get-CMSecurityRolePermission

Obter as permissões para a função de segurança especificada.

Syntax

Get-CMSecurityRolePermission
   -Name <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
Get-CMSecurityRolePermission
   -Id <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
Get-CMSecurityRolePermission
   -InputObject <IResultObject>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

Description

Use este cmdlet para obter as permissões para a função de segurança especificada. Para obter mais informações sobre funções e permissões de segurança, consulte Fundamentos daadministração baseada em função no 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 cmdlets do Configuration Manager na unidade de site do Configuration Manager, por PS XYZ:\> exemplo. Para obter mais informações, consulte getting started.

Exemplos

Exemplo 1: Obter permissões para uma função específica

Este exemplo obtém primeiro um objeto para a função de segurança interna Autor do aplicativo na variável $role. Em seguida, ele passa esse objeto para o cmdlet Get-CMSecurityRolePermission e salva a lista de permissões na variável $rolePermission.

$roleName = "Application author"
$role = Get-CMSecurityRole -Name $roleName
$rolePermission = $role | Get-CMSecurityRolePermission

Exemplo 2: Exibir classes para uma função específica

Este exemplo é semelhante ao exemplo anterior, mas filtra e classifica os resultados de maneira diferente. Ele exibe apenas os nomes de classe aos quais a função tem permissões e classifica a lista em ordem alfabética.

$rolePermission | Select-Object ObjectTypeDisplayName | Sort-Object -Property ObjectTypeDisplayName

Parâmetros

-DisableWildcardHandling

Este parâmetro trata caracteres curinga como valores literais de caracteres. Não é possível combiná-lo com ForceWildcardHandling.

Type:SwitchParameter
Position:Named
Default value:None
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). Não é possível combiná-lo com DisableWildcardHandling.

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

-Id

Especifique a ID da função de segurança para obter suas permissões. Esse valor é a RoleID propriedade, por SMS000AR exemplo, para a função gerenciador de implantação do sistema operacional.

Para exibir todas as funções e IDs do site, use o seguinte comando:

Get-CMSecurityRole | Select-Object RoleID, RoleName

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

-InputObject

Especifique um objeto de função de segurança para obter suas permissões. Para obter esse objeto, use o cmdlet Get-CMSecurityRole.

Type:IResultObject
Aliases:SecurityRole
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-Name

Especifique o nome da função de segurança para obter suas permissões.

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

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Saídas

IResultObject[]

IResultObject

Observações

O objeto return é RoleOperation a classe, que inclui uma instância da SMS_ARoleOperation classe. Para obter mais informações, consulte SMS_ARoleOperation WMI do servidor.