Add-PublicFolderAdministrativePermission

  • Referência
Módulo:
ExchangePowerShell
Aplica-se a:
Exchange Server 2010

Esse cmdlet só está disponível no Exchange Server 2010.

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

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

Syntax

Add-PublicFolderAdministrativePermission
   [-Identity] <PublicFolderIdParameter>
   -AccessRights <MultiValuedProperty>
   -User <SecurityPrincipalIdParameter>
   [-Confirm]
   [-Deny]
   [-DomainController <Fqdn>]
   [-InheritanceType <ActiveDirectorySecurityInheritance>]
   [-Server <ServerIdParameter>]
   [-WhatIf]
   [<CommonParameters>]
Add-PublicFolderAdministrativePermission
   [[-Identity] <PublicFolderIdParameter>]
   -Instance <PublicFolderAdministrativeAceObject>
   [-AccessRights <MultiValuedProperty>]
   [-User <SecurityPrincipalIdParameter>]
   [-Confirm]
   [-Deny]
   [-DomainController <Fqdn>]
   [-InheritanceType <ActiveDirectorySecurityInheritance>]
   [-Server <ServerIdParameter>]
   [-WhatIf]
   [<CommonParameters>]
Add-PublicFolderAdministrativePermission
   [-Identity] <PublicFolderIdParameter>
   -Owner <SecurityPrincipalIdParameter>
   [-Confirm]
   [-DomainController <Fqdn>]
   [-Server <ServerIdParameter>]
   [-WhatIf]
   [<CommonParameters>]

Description

Para executar esse cmdlet, você precisa ter permissões. Embora este tópico 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

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

Este exemplo concede ao usuário Chris a permissão ViewInformationStore na pasta pública MyPublicFolder.

Exemplo 2

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

Este exemplo nega ao usuário Chris a permissão ViewInformationStore.

Parâmetros

-AccessRights

O parâmetro AccessRights especifica os direitos que você deseja adicionar para o administrador na pasta pública. Os valores válidos incluem:

  • Nenhum O administrador não tem direitos de modificar atributos de pasta pública.
  • ModifiPublicFolderACL O administrador tem o direito de modificar as permissões de acesso do cliente para a pasta especificada.
  • ModifiPublicFolderAdminACL O administrador tem o direito de modificar permissões de administrador para a pasta pública especificada.
  • ModifiPublicFolderDeletedItemRetention O administrador tem o direito de modificar os atributos de retenção de item excluídos da pasta pública (RetainDeletedItemsFor e UseDatabaseRetentionDefaults).
  • ModifiPublicFolderExpiry O administrador tem o direito de modificar os atributos expiração de pasta pública (AgeLimit e UseDatabaseAgeDefaults).
  • ModifiPublicFolderQuotas O administrador tem o direito de modificar os atributos cota de pasta pública (MaxItemSize, PostQuota, PostWarningQuota e UseDatabaseQuotaDefaults)
  • ModifiPublicFolderReplicaList O administrador tem o direito de modificar o atributo de lista de réplicas para a pasta pública especificada (Réplicas).
  • AdministerInformationStore O administrador tem o direito de modificar todas as outras propriedades de pasta pública que não foram definidas anteriormente.
  • ViewInformationStore O administrador tem o direito de exibir propriedades de pasta pública.
  • AllExtendedRights O administrador tem o direito de modificar todas as propriedades da pasta pública.

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

Você não pode usar esse parâmetro com o parâmetro Proprietário.

Type:MultiValuedProperty
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-Confirm

A opção Confirm especifica se a solicitação de confirmação deve ser mostrada ou ocultada. Como essa opção afeta o cmdlet dependerá do fato de o cmdlet exigir ou não confirmação antes de continuar.

  • Cmdlets destrutivos (por exemplo, cmdlets Remove-*) têm uma pausa interna que força você a reconhecer o comando antes de prosseguir. Para estes cmdlets, você pode pular o pedido de confirmação usando esta sintaxe exata: -Confirm:$false.
  • A maioria dos outros cmdlets (por exemplo, cmdlets 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 confirmar o comando antes de continuar.
Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-Deny

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-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.

Type:Fqdn
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-Identity

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

O rótulo do parâmetro pode ser omitido, para que apenas o nome da pasta pública ou o GUID sejam fornecidos.

Type:PublicFolderIdParameter
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2010

-InheritanceType

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

  • Nenhum
  • Tudo (esse é o valor padrão)
  • Children
  • Descendentes [sic]
  • SelfAndChildren
Type:ActiveDirectorySecurityInheritance
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-Instance

O parâmetro Instância especifica se deve passar 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.

Type:PublicFolderAdministrativeAceObject
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2010

-Owner

O parâmetro Proprietário especifica o proprietário do objeto de pasta pública. Você pode especificar os seguintes tipos de usuários ou grupos (entidades de segurança) para este parâmetro:

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

É possível usar qualquer valor que identifique o usuário ou grupo com exclusividade. Por exemplo:

  • Nome
  • Alias
  • Nome diferenciado (DN)
  • Nome diferenciado (DN)
  • Domain\username
  • Endereço de email
  • GUID
  • LegacyExchangeDN
  • SamAccountName
  • ID de usuário ou nome UPN

Você não pode usar esse parâmetro com os parâmetros AccessRights ou User.

Type:SecurityPrincipalIdParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-Server

O parâmetro Servidor especifica o servidor Exchange em que você deseja executar esse comando. É possível usar qualquer valor que identifique o servidor com exclusividade. Por exemplo:

  • Nome
  • FQDN
  • DN (nome diferenciado)
  • DN Herdado do Exchange

DN Herdado do Exchange

Type:ServerIdParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-User

O parâmetro User especifica quem obtém as permissões de administrador na pasta pública. É 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

É possível usar qualquer valor que identifique o usuário ou grupo com exclusividade. Por exemplo:

  • Nome
  • Alias
  • Nome diferenciado (DN)
  • Nome diferenciado (DN)
  • Domain\username
  • Endereço de email
  • GUID
  • LegacyExchangeDN
  • SamAccountName
  • ID de usuário ou nome UPN

Você não pode usar esse parâmetro com o parâmetro Proprietário.

Type:SecurityPrincipalIdParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-WhatIf

A opção WhatIf simula as ações do comando. Você pode usar essa opção para exibir as alterações que ocorreriam sem realmente aplicar essas alterações. Não é preciso especificar um valor com essa opção.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

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.