Add-MailboxFolderPermission

  • Referência
Módulo:
ExchangePowerShell
Aplica-se a:
Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

Este cmdlet está disponível no Exchange local e no serviço baseado na nuvem. Alguns parâmetros e configurações podem ser exclusivos de um ou outro ambiente.

Use o cmdlet Add-MailboxFolderPermission para adicionar as permissões no nível de pasta para usuários em caixas de correio.

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

Syntax

Add-MailboxFolderPermission
   [-Identity] <MailboxFolderIdParameter>
   -AccessRights <MailboxFolderAccessRight[]>
   -User <MailboxFolderUserIdParameter>
   [-Confirm]
   [-DomainController <Fqdn>]
   [-SendNotificationToUser <Boolean>]
   [-SharingPermissionFlags <MailboxFolderPermissionFlags>]
   [-WhatIf]
   [<CommonParameters>]

Description

Para modificar as permissões que são atribuídas ao usuário em uma pasta da caixa de correio, use o cmdlet Set-MailboxFolderPermission. Para remover todas as permissões que são atribuídas a um usuário em uma pasta da caixa de correio, use o cmdlet Remove-MailboxFolderPermission.

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-MailboxFolderPermission -Identity ayla@contoso.com:\Marketing -User ed@contoso.com -AccessRights Owner

Este exemplo concede a função Proprietário à Eduardo na pasta Marketing da caixa de correio de Lara.

Exemplo 2

Add-MailboxFolderPermission -Identity ayla@contoso.com:\Calendar -User julia@contoso.com -AccessRights Editor -SharingPermissionFlags Delegate

Em Exchange Online, este exemplo adiciona Julia como delegada de calendário à caixa de correio de Ayla, mas sem acesso a itens privados.

Exemplo 3

Add-MailboxFolderPermission -Identity ayla@contoso.com:\Calendar -User laura@contoso.com -AccessRights Editor -SharingPermissionFlags Delegate,CanViewPrivateItems

Em Exchange Online, este exemplo adiciona Laura como delegada de calendário à caixa de correio da Ayla com acesso a itens privados.

Parâmetros

-AccessRights

O parâmetro AccessRights especifica as permissões que você quer adicionar para o usuário na pasta da caixa de correio.

Você pode especificar permissões de pastas individuais ou funções, que são combinações de permissões. Você pode especificar várias permissões e funções separadas por vírgulas.

As seguintes permissões individuais estão disponíveis:

  • Nenhum: o usuário não tem acesso para exibir ou interagir com a pasta ou seu conteúdo.
  • CreateItems: o usuário pode criar itens dentro da pasta especificada.
  • CreateSubfolders: o usuário pode criar subpastas na pasta especificada.
  • DeleteAllItems: o usuário pode excluir todos os itens na pasta especificada.
  • DeleteOwnedItems: o usuário só pode excluir itens criados a partir da pasta especificada.
  • EditAllItems: o usuário pode editar todos os itens na pasta especificada.
  • EditOwnedItems: o usuário só pode editar itens criados na pasta especificada.
  • FolderContact: o usuário é o contato da pasta pública especificada.
  • FolderOwner: o usuário é o proprietário da pasta especificada. O usuário pode exibir a pasta, mover a pasta e criar subpastas. O usuário não pode ler itens, editar itens, excluir itens ou criar itens.
  • FolderVisible: o usuário pode exibir a pasta especificada, mas não pode ler ou editar itens dentro da pasta pública especificada.
  • ReadItems: o usuário pode ler itens dentro da pasta especificada.

As funções disponíveis, além das permissões que elas atribuem, são descritas na lista a seguir:

  • Autor: CreateItems, DeleteOwnedItems, EditOwnedItems, FolderVisible, ReadItems
  • Colaborador: CreateItems, FolderVisible
  • Editor: CreateItems, DeleteAllItems, DeleteOwnedItems, EditAllItems, EditOwnedItems, FolderVisible, ReadItems
  • NonEditingAuthor: CreateItems, DeleteOwnedItems, FolderVisible, ReadItems
  • Proprietário: CreateItems, CreateSubfolders, DeleteAllItems, DeleteOwnedItems, EditAllItems, EditOwnedItems, FolderContact, FolderOwner, FolderVisible, ReadItems
  • PublishingAuthor: CreateItems, CreateSubfolders, DeleteOwnedItems, EditOwnedItems, FolderVisible, ReadItems
  • PublishingEditor: CreateItems, CreateSubfolders, DeleteAllItems, DeleteOwnedItems, EditAllItems, EditOwnedItems, FolderVisible, ReadItems
  • Revisor: FolderVisible, ReadItems

As seguintes funções se aplicam especificamente a pastas de calendário:

  • DisponibilidadeOnly: exibir somente dados de disponibilidade
  • LimitedDetails: exibir dados de disponibilidade com assunto e local

Quando a função Editor é aplicada a pastas de calendário, os delegados podem aceitar ou recusar reuniões selecionando manualmente a solicitação de reunião na caixa de correio. Em Exchange Online, para enviar solicitações de reunião aos delegados em que possam aceitar ou recusar reuniões, use também o parâmetro SharingPermissionFlags com o valor Delegado.

Type:MailboxFolderAccessRight[]
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-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, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-DomainController

Este parâmetro está disponível somente no Exchange local.

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, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Identity

O parâmetro Identity especifica a caixa de correio e a pasta de destino. A sintaxe é MailboxID:\ParentFolder[\SubFolder].

Para o valor de MailboxID, você pode usar qualquer valor que identifique exclusivamente a caixa de correio. 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

Os valores de exemplo para esse parâmetro são john@contoso.com:\Calendar ou John:\Inbox\Reports.

Type:MailboxFolderIdParameter
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-SendNotificationToUser

Esse parâmetro só está disponível no serviço baseado em nuvem.

O parâmetro SendNotificationToUser especifica se é necessário enviar um convite de compartilhamento ao usuário ao adicionar permissões de calendário para eles. A mensagem será um convite normal de compartilhamento de calendário que pode ser aceito pelo destinatário. Os valores válidos são:

  • $true: um convite de compartilhamento é enviado.
  • $false: nenhum convite de compartilhamento é enviado. Esse é o valor padrão.

Esse parâmetro só se aplica a pastas de calendário e só pode ser usado com os seguintes valores de parâmetro AccessRights:

  • DisponibilidadeOnly
  • LimitedDetails
  • Revisor
  • Editor
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-SharingPermissionFlags

Esse parâmetro só está disponível no serviço baseado em nuvem.

O parâmetro SharingPermissionFlags atribui permissões de delegado de calendário. Esse parâmetro só se aplica a pastas de calendário e só pode ser usado quando o valor do parâmetro AccessRights for Editor. Os valores válidos são:

  • Nenhum: não tem efeito. Esse é o valor padrão.
  • Delegado: o usuário é feito um delegado de calendário, que inclui o recebimento de convites e respostas da reunião. Se não houver outros delegados, esse valor criará a regra da mensagem de reunião. Se houver delegados existentes, o usuário será adicionado à regra da mensagem de reunião sem alterar a forma como as mensagens de delegado são enviadas.
  • CanViewPrivateItems: o usuário pode acessar itens privados no calendário. Você deve usar esse valor com o valor Delegado.

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

Observação: você não pode configurar as solicitações de reunião do Deliver endereçadas a mim e respostas a solicitações de reunião em que sou o organizador da configuração do Outlook no PowerShell. Mas, você pode configurar a configuração usando o EWS (Exchange Web Services). Para obter mais informações, consulte MeetingRequestsDeliveryScope Enum.

Type:MailboxFolderPermissionFlags
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-User

O parâmetro User especifica quem recebeu permissão para a pasta da caixa de correio. Os valores válidos são entidades de segurança habilitadas para email (contas ou grupos habilitados para email que têm identificadores de segurança ou SIDs que podem ter permissões atribuídas a eles). Por exemplo:

  • Caixas de correio de usuário
  • Usuários de email
  • Grupos de segurança habilitados para email

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

  • Nome
  • Alias
  • Nome diferenciado (DN)
  • Nome diferenciado (DN)
  • DN canônico
  • GUID
Type:MailboxFolderUserIdParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-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, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

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.