Get-ADPermission

Módulo:: Exchange PowerShell

Este cmdlet está disponível somente no Exchange local.

Use o cmdlet Get-ADPermission para obter permissões em um objeto do Active Directory.

Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.

Sintaxe

Owner

Get-ADPermission
    [-Identity] <ADRawEntryIdParameter>
    [-Owner]
    [-DomainController <Fqdn>]
    [<CommonParameters>]

AccessRights

Get-ADPermission
    [-Identity] <ADRawEntryIdParameter>
    [-User <SecurityPrincipalIdParameter>]
    [-DomainController <Fqdn>]
    [<CommonParameters>]

Description

Os cmdlets ADPermission podem ser usados para modificar diretamente as ACLs (listas de controle de acesso) do Active Directory. Embora alguns recursos do Microsoft Exchange possam continuar a usar os cmdlets ADPermission para gerenciar permissões (por exemplo, conectores de envio e recebimento), o Exchange 2013 e versões posteriores não usam mais ACLs personalizadas para gerenciar permissões administrativas. Se você quiser conceder ou negar permissões administrativas no Exchange 2013 ou posterior, precisará usar o RBAC (Controle de Acesso Baseado em Função). Para obter mais informações sobre RBAC, consulte Permissões no Exchange Server.

Para executar esse cmdlet, você precisa ter permissões. Embora este artigo liste todos os parâmetros do cmdlet, talvez você não tenha acesso a alguns parâmetros se eles não estiverem incluídos nas permissões atribuídas a você. Para localizar as permissões necessárias para executar qualquer cmdlet ou parâmetro em sua organização, confira Find the permissions required to run any Exchange cmdlet.

Exemplos

Exemplo 1

Get-ADPermission -Identity Ed

Este exemplo retorna as permissões aplicadas ao usuário Ed.

Exemplo 2

Get-ADPermission "Contoso.com" -User Chris

Este exemplo retorna as permissões concedidas ao usuário Chris no conector de recebimento Contoso.com.

Parâmetros

-DomainController

Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

O parâmetro DomainController especifica o controlador de domínio que é usado por esse cmdlet para ler dados ou gravar dados no Active Directory. Você identifica o controlador de domínio por seu FQDN (nome de domínio totalmente qualificado). Por exemplo, dc01.contoso.com.

O parâmetro DomainController não é compatível com os servidores de Transporte do Microsoft Edge. Um servidor de Transporte do Microsoft Edge usa a instância local dos Serviços AD LDS para ler e gravar dados.

Propriedades do parâmetro

Tipo:	Fqdn
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-Identity

Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

O parâmetro Identity especifica a identidade do objeto para o qual você está recuperando permissões. Você pode recuperar as permissões para qualquer objeto do Active Directory usando seu DN (nome diferenciado). Se o objeto for um objeto do Exchange, você poderá usar o nome do objeto. Se o DN ou o nome do objeto contiver espaços, coloque o valor entre aspas (").

Cuidado: O valor $null ou um valor inexistente para o parâmetro Identity retorna todos os objetos como se você tivesse executado o comando Get- sem o parâmetro Identity. Verifique se todas as listas de valores para o parâmetro Identity são precisas e não contêm valores de $null inexistentes.

Propriedades do parâmetro

Tipo:	ADRawEntryIdParameter
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	1
Obrigatório:	True
Valor do pipeline:	True
Valor do pipeline pelo nome da propriedade:	True
Valor dos argumentos restantes:	False

-Owner

Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

A opção Owner retorna o proprietário do objeto do Active Directory. Não é preciso especificar um valor com essa opção.

Não é possível usar essa opção com o parâmetro User.

Propriedades do parâmetro

Tipo:	SwitchParameter
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

Owner

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-User

Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

O parâmetro user filtra os resultados que têm permissões no objeto do Active Directory. Você pode especificar os seguintes tipos de usuários ou grupos (entidades de segurança) para esse parâmetro:

Usuário da caixa de correio
Usuários de e-mail
Grupos de segurança

Para obter os melhores resultados, recomendamos o uso dos seguintes valores:

UPN: por exemplo, user@contoso.com (somente usuários).
Domain\SamAccountName: Por exemplo, contoso\user.

Caso contrário, você poderá usar qualquer valor que identifique exclusivamente o usuário ou grupo. Por exemplo:

Nome
Alias
Nome diferenciado (DN)
Nome diferenciado (DN)
Domínio\Nome de usuário
Endereço de email
GUID
LegacyExchangeDN
SamAccountName
ID de usuário ou nome UPN

Não é possível usar esse parâmetro com o parâmetro Owner.

Propriedades do parâmetro

Tipo:	SecurityPrincipalIdParameter
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

AccessRights

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

CommonParameters

Este cmdlet dá suporte aos parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, confira about_CommonParameters.

Entradas

Input types

Para ver os tipos de entrada que este cmdlet aceita, confira Tipos de entrada e saída de cmdlet. Se o campo Tipo de Entrada de um cmdlet estiver em branco, isso significa que o cmdlet não aceita dados de entrada.

Saídas

Output types

Para ver os tipos de retorno, também conhecidos como tipos de saída, que este cmdlet aceita, consulte Tipos de entrada e saída de cmdlet. Se o campo Tipo de Saída estiver em branco, o cmdlet não retorna dados.

Comentários

Esta página foi útil?