Remove-ADPermission

Módulo:: Exchange PowerShell

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

Use o cmdlet Remove-ADPermission para remover permissões de um objeto do Active Directory.

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

Sintaxe

AccessRights

Remove-ADPermission
    [-Identity] <ADRawEntryIdParameter>
    -User <SecurityPrincipalIdParameter>
    [-AccessRights <ActiveDirectoryRights[]>]
    [-ChildObjectTypes <ADSchemaObjectIdParameter[]>]
    [-Confirm]
    [-Deny]
    [-DomainController <Fqdn>]
    [-ExtendedRights <ExtendedRightIdParameter[]>]
    [-InheritanceType <ActiveDirectorySecurityInheritance>]
    [-InheritedObjectType <ADSchemaObjectIdParameter>]
    [-Properties <ADSchemaObjectIdParameter[]>]
    [-WhatIf]
    [<CommonParameters>]

Owner

Remove-ADPermission
    [-Identity] <ADRawEntryIdParameter>
    [-Confirm]
    [-DomainController <Fqdn>]
    [-WhatIf]
    [<CommonParameters>]

Instance

Remove-ADPermission
    [[-Identity] <ADRawEntryIdParameter>]
    -Instance <ADAcePresentationObject>
    [-AccessRights <ActiveDirectoryRights[]>]
    [-ChildObjectTypes <ADSchemaObjectIdParameter[]>]
    [-Confirm]
    [-Deny]
    [-DomainController <Fqdn>]
    [-ExtendedRights <ExtendedRightIdParameter[]>]
    [-InheritanceType <ActiveDirectorySecurityInheritance>]
    [-InheritedObjectType <ADSchemaObjectIdParameter>]
    [-Properties <ADSchemaObjectIdParameter[]>]
    [-User <SecurityPrincipalIdParameter>]
    [-WhatIf]
    [<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

Remove-ADPermission -Identity Administrator -User Kim -ExtendedRights "Send As"

Este exemplo remove as permissões Enviar como da usuária Kim no usuário Administrador.

Exemplo 2

Remove-ADPermission "IP Secured Inbound" -User "NT AUTHORITY\ANONYMOUS LOGON" -ExtendedRights ms-Exch-SMTP-Submit,ms-Exch-SMTP-Accept-Any-Recipient,ms-Exch-Bypass-Anti-Spam

Este exemplo remove a capacidade de usuários anônimos enviarem mensagens pelo Conector de recebimento de Entrada segura de IP.

Parâmetros

-AccessRights

O parâmetro AccessRights especifica os direitos que você deseja remover do usuário no objeto do Active Directory. Os valores válidos incluem:

CreateChild
DeleteChild
ListChildren
Self
ReadProperty
WriteProperty
DeleteTree
ListObject
ExtendedRight
Excluir
ReadControl
GenericExecute
GenericWrite
GenericRead
WriteDacl
WriteOwner
GenericAll
Synchronize
AccessSystemSecurity

Vários valores, separados por vírgulas, podem ser especificados.

Propriedades do parâmetro

Tipo:	ActiveDirectoryRights[]
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

-ChildObjectTypes

O parâmetro ChildObjectTypes especifica de que tipo de objeto a permissão deve ser removida.

O parâmetro ChildObjectTypes só poderá ser usado se o parâmetro AccessRights for definido como CreateChild ou DeleteChild.

Propriedades do parâmetro

Tipo:	ADSchemaObjectIdParameter[]
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

-Confirm

A opção Confirm especifica se a solicitação de confirmação deve ser mostrada ou ocultada. A forma como essa opção afeta o cmdlet depende se o cmdlet requer confirmação antes de continuar.

Cmdlets destrutivos (por exemplo, Remover- cmdlets) têm uma pausa interna que força você a confirmar o comando antes de continuar. Para estes cmdlets, você pode pular o pedido de confirmação usando esta sintaxe exata: -Confirm:$false.
A maioria dos outros cmdlets (por exemplo, New- e Set-) não tem uma pausa interna. Para esses cmdlets, especificar a opção Confirm sem um valor introduz uma pausa que força você a reconhecer o comando antes de continuar.

Propriedades do parâmetro

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

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

-Deny

A opção Negar especifica que as permissões que você está removendo são permissões Negar. Não é preciso especificar um valor com essa opção.

Propriedades do parâmetro

Tipo:	SwitchParameter
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

-DomainController

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

-ExtendedRights

O parâmetro ExtendedRights especifica os direitos estendidos a remover.

Propriedades do parâmetro

Tipo:	ExtendedRightIdParameter[]
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

O parâmetro Identity especifica o objeto do qual as permissões devem ser removidas.

Será possível especificar o DN (nome distinto) do objeto ou o nome do objeto se ele for exclusivo. Se o DN ou o nome contiver espaços, coloque-o entre aspas (").

Propriedades do parâmetro

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

Conjuntos de parâmetros

AccessRights

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

Owner

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

Instance

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

-InheritanceType

O parâmetro InheritanceType especifica como as permissões são herdadas. Os valores válidos são:

Nenhum
Todos (este é o valor padrão)
Crianças
Descendentes [sic]
SelfAndChildren

Propriedades do parâmetro

Tipo:	ActiveDirectorySecurityInheritance
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

-InheritedObjectType

O parâmetro InheritedObjectType especifica que tipo de objeto herda essa ACE (entrada de controle de acesso).

Propriedades do parâmetro

Tipo:	ADSchemaObjectIdParameter
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

-Instance

O parâmetro Instance permite que você passe um objeto inteiro para o comando a ser processado. Ele é principalmente usado em scripts nos quais todo um objeto deve ser passado para o comando.

Propriedades do parâmetro

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

Conjuntos de parâmetros

Instance

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

-Properties

O parâmetro Properties especifica as propriedades que o objeto contém.

O parâmetro Properties só poderá ser usado se o parâmetro AccessRights estiver definido como ReadProperty, WriteProperty ou Self.

Propriedades do parâmetro

Tipo:	ADSchemaObjectIdParameter[]
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

-User

O parâmetro User especifica quais permissões estão sendo removidas do objeto do Active Directory. É possível especificar os seguintes tipos de usuários ou grupos:

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

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:	True
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

Instance

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

-WhatIf

A opção WhatIf mostra o que o comando faz sem fazer nenhuma alteração. Não é preciso especificar um valor com essa opção.

Propriedades do parâmetro

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

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

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?