Add-PublicFolderAdministrativePermission

  • Artigo

 

Aplica-se a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

Tópico modificado em: 2009-05-12

Use o cmdlet Add-PublicFolderAdministrativePermission para adicionar permissões administrativas a uma pasta pública ou uma hierarquia de pasta pública.

Sintaxe

Add-PublicFolderAdministrativePermission -Identity <PublicFolderIdParameter> -AccessRights <Collection> -User <SecurityPrincipalIdParameter> [-Confirm [<SwitchParameter>]] [-Deny <SwitchParameter>] [-DomainController <Fqdn>] [-InheritanceType <None | All | Descendents | SelfAndChildren | Children>] [-Server <ServerIdParameter>] [-WhatIf [<SwitchParameter>]]

Add-PublicFolderAdministrativePermission [-Identity <PublicFolderIdParameter>] -Instance <PublicFolderAdministrativeAceObject> [-AccessRights <Collection>] [-Confirm [<SwitchParameter>]] [-Deny <SwitchParameter>] [-DomainController <Fqdn>] [-InheritanceType <None | All | Descendents | SelfAndChildren | Children>] [-Server <ServerIdParameter>] [-User <SecurityPrincipalIdParameter>] [-WhatIf [<SwitchParameter>]]

Add-PublicFolderAdministrativePermission -Identity <PublicFolderIdParameter> -Owner <SecurityPrincipalIdParameter> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Server <ServerIdParameter>] [-WhatIf [<SwitchParameter>]]

Descrição detalhada

Para executar o cmdlet Add-PublicFolderAdministrativePermission, você deve usar a conta à qual esteja delegada a seguinte função:

  • Função de Administrador de Pasta Pública do Exchange e grupo Administradores local no servidor de destino

Para obter mais informações sobre permissões, delegação de funções e os direitos necessários para administrar o Exchange Server 2007, consulte Considerações sobre permissão.

Parâmetros

Parâmetro Necessário(s) Tipo Descrição

AccessRights

Necessário(s)

System.Collections.ObjectModel.Collection

O parâmetro AccessRights especifica os direitos que estão sendo adicionados. Os valores válidos incluem:

  • None   O administrador não tem direitos para modificar atributos da pasta pública.

  • ModifyPublicFolderACL   O administrador tem direito para modificar permissões de acesso ao cliente na pasta especificada.

  • ModifyPublicFolderAdminACL   O administrador tem direito para modificar permissões de administrador na pasta pública especificada.

  • ModifyPublicFolderDeletedItemRetention   O administrador tem direito para modificar os atributos de Retenção de Item Excluído em Pasta Pública (RetainDeletedItemsFor, UseDatabaseRetentionDefaults).

  • ModifyPublicFolderExpiry   O administrador tem direito para modificar os atributos de Expiração de Pasta Pública (AgeLimit, UseDatabaseAgeDefaults).

  • ModifyPublicFolderQuotas   O administrador tem direito para modificar os atributos de Cota de Pasta Pública (MaxItemSize, PostQuota, PostWarningQuota, UseDatabaseQuotaDefaults)

  • ModifyPublicFolderReplicaList   O administrador tem direito para modificar o atributo de lista de réplicas na pasta pública especificada (Replicas).

  • AdministerInformationStore O administrador tem direito para modificar todas as outras propriedades da pasta pública que não estejam definidas acima.

  • ViewInformationStore   O administrador tem direito para exibir propriedades da pasta pública.

  • AllExtendedRights   O administrador tem direito para modificar todas as propriedades da pasta pública.

Identity

Necessário(s)

Microsoft.Exchange.Configuration.Tasks.PublicFolderIdParameter

Utilize o parâmetro Identity para especificar a GUID ou o nome da pasta pública que representa uma pasta pública específica. Você pode também incluir o caminho utilizando o formato TopLevelPublicFolder\PublicFolder.

Você pode omitir o rótulo do parâmetro Identity para que somente o nome da pasta pública ou a GUID seja fornecido.

Instance

Necessário(s)

Microsoft.Exchange.Management.MapiTasks.PublicFolderAdministrativeAceObject

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

Owner

Necessário(s)

Microsoft.Exchange.Configuration.Tasks.SecurityPrincipalIdParameter

O parâmetro Owner especifica a ACL (lista de controle de acesso) do Proprietário NT no objeto. Os valores válidos são o nome UPN, o domínio\usuário ou o alias.

User

Necessário(s)

Microsoft.Exchange.Configuration.Tasks.SecurityPrincipalIdParameter

O parâmetro User especifica o nome UPN, domínio\usuário ou alias do usuário para quem os direitos estão sendo adicionados.

Confirm

Opcional

System.Management.Automation.SwitchParameter

O parâmetro Confirm faz com que o comando pause o processamento e exige que você confirme o que o comando fará antes que o processamento continue. Você não precisa especificar um valor com o parâmetro Confirm.

Deny

Opcional

System.Management.Automation.SwitchParameter

O parâmetro Deny é uma opção que, se incluída, nega a permissão especificada.

DomainController

Opcional

Microsoft.Exchange.Data.Fqdn

O parâmetro DomainController especifica o controlador de domínio a ser usado para gravar essa alteração de configuração no Active Directory. Use o nome de domínio totalmente qualificado (FQDN) do controlador de domínio a ser usado.

InheritanceType

Opcional

System.DirectoryServices.ActiveDirectorySecurityInheritance

O parâmetro InheritanceType especifica o tipo de herança. Os valores válidos são:

  • Nenhum

  • All

  • Descendents

  • SelfAndChildren

  • Children

Server

Opcional

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

O parâmetro Server especifica o servidor no qual executar as operações selecionadas.

WhatIf

Opcional

System.Management.Automation.SwitchParameter

O parâmetro WhatIf instrui o comando a simular as ações que ele executará no objeto. Ao usar o parâmetro WhatIf, você poderá visualizar quais alterações ocorrerão sem precisar aplicar nenhuma dessas alterações. Você não precisa especificar um valor com o parâmetro WhatIf.

Tipos de entrada

Tipos de retorno

Erros

Erro Descrição

 

Exceções

Exceções Descrição

 

Exemplo

No primeiro exemplo, a permissão ViewInformationStore é atribuída a um usuário chamado Chris na pasta pública denominada MyPublicFolder.

No segundo exemplo, o parâmetro Deny é adicionado ao comando do primeiro exemplo, que nega ao usuário chamado Chris a permissão ViewInformationStore.

Add-PublicFolderAdministrativePermission -User Chris -Identity \MyPublicFolder -AccessRights ViewInformationStore

Add-PublicFolderAdministrativePermission -User Chris -Identity \MyPublicFolder -AccessRights ViewInformationStore -Deny

Use o cmdlet Add-PublicFolderClientPermission para adicionar permissões de usuário a uma pasta pública.