Add-MailboxFolderPermission
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 ambiente ou de outro.
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.
Sintaxe
Default (Default)
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 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
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
No Exchange Online, esse exemplo adiciona Júlia como uma delegada de calendário à caixa de correio de Ayla, mas sem acesso a itens particulares.
Exemplo 3
Add-MailboxFolderPermission -Identity ayla@contoso.com:\Calendar -User laura@contoso.com -AccessRights Editor -SharingPermissionFlags Delegate,CanViewPrivateItems
No Exchange Online, este exemplo adiciona Laura como uma delegada de calendário à caixa de correio de Ayla com acesso a itens particulares.
Parâmetros
-AccessRights
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
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 na 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 ou 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:
- AvailabilityOnly: 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 representantes podem aceitar ou recusar reuniões selecionando manualmente a solicitação de reunião na caixa de correio. No Exchange Online, para enviar solicitações de reunião para representantes onde eles podem aceitar ou recusar reuniões, use também o parâmetro SharingPermissionFlags com o valor Delegate.
Propriedades do parâmetro
| Tipo: | MailboxFolderAccessRight[] |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Confirm
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
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 |
-DomainController
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
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.
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, Exchange Online
O parâmetro Identity especifica a caixa de correio e a pasta de destino. A sintaxe é MailboxID:\ParentFolder[\SubFolder].
Para o valor de , você pode usar qualquer valor que identifique exclusivamente a caixa de MailboxIDcorreio. 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
Os valores de exemplo para este parâmetro são john@contoso.com:\Calendar ou John:\Inbox\Reports.
Propriedades do parâmetro
| Tipo: | MailboxFolderIdParameter |
| 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 |
-SendNotificationToUser
Aplicável: Exchange Online
Esse parâmetro só está disponível no serviço baseado em nuvem.
O parâmetro SendNotificationToUser especifica se um convite de compartilhamento deve ser enviado ao usuário quando você adiciona permissões de calendário para ele. A mensagem é um convite normal de compartilhamento de calendário que pode ser aceito pelo destinatário. Os valores válidos são:
- $true: um convite para compartilhamento é enviado.
- $false: Nenhum convite para compartilhamento é enviado. Esse valor é o 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:
- AvailabilityOnly
- Detalhes Limitados
- Revisor
- Editor
Propriedades do parâmetro
| Tipo: | Boolean |
| 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 |
-SharingPermissionFlags
Aplicável: Exchange Online
Esse parâmetro só está disponível no serviço baseado em nuvem.
O parâmetro SharingPermissionFlags atribui permissões de representante 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 valor é o padrão.
- Representante: o usuário recebe um representante de calendário, o que inclui o recebimento de convites e respostas para reuniões. Se não houver outros representantes, esse valor criará a regra de mensagem da reunião. Se houver representantes existentes, o usuário será adicionado à regra de mensagem de reunião sem alterar como as mensagens de representante são enviadas.
- CanViewPrivateItems: o usuário pode acessar itens particulares no calendário. Você deve usar esse valor com o valor Delegate.
Vários valores, separados por vírgulas, podem ser especificados.
Observação: você não pode configurar a configuração Entregar solicitações de reunião endereçadas a mim e respostas a solicitações de reunião em que eu sou o organizador para o Outlook no PowerShell. Porém, você pode definir a configuração usando o Serviços Web do Exchange (EWS). Para obter mais informações, consulte MeetingRequestsDeliveryScope Enum.
Propriedades do parâmetro
| Tipo: | MailboxFolderPermissionFlags |
| 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
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
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 e-mail
- Grupos de segurança habilitados para email (incluindo grupos de segurança aninhados habilitados para email)
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)
- DN canônico
- GUID
Propriedades do parâmetro
| Tipo: | MailboxFolderUserIdParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-WhatIf
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
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.