Compartilhar via

Set-MailboxFolderPermission

Módulo:
Exchange PowerShell

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

Utilize o cmdlet Set-MailboxFolderPermission para modificar as permissões ao nível da pasta para os utilizadores nas caixas de correio. Este cmdlet difere do cmdlet Add-MailboxFolderPermission no qual modifica entradas de permissão existentes. Para configurar as definições de publicação ou partilha de calendários para uma caixa de correio para que as informações do calendário fiquem visíveis para utilizadores externos, utilize o cmdlet Set-MailboxCalendarFolder.

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

Sintaxe

Default (Padrão) 

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

Description

No Exchange Online PowerShell, se não utilizar os parâmetros SendNotificationToUser ou SharingPermissionFlags, não existem alterações à funcionalidade do cmdlet. Por exemplo, se o utilizador for um delegado existente e alterar as respetivas permissões para Editor sem utilizar os parâmetros SendNotificationToUser ou SharingPermissionFlags, o utilizador continua a ser delegado. No entanto, se utilizar o parâmetro SendNotificationToUser ($true ou $false), o parâmetro SharingPermissionFlags tem o valor predefinido None, que pode afetar o acesso delegado aos utilizadores existentes. Por exemplo, pode alterar a permissão de um delegado existente para Editor e utilizar SendNotificationToUser com o valor $true. O utilizador já não é delegado e só tem permissões de Editor para a pasta.

Para executar esse cmdlet, você precisa ter permissões. Embora este artigo liste todos os parâmetros do cmdlet, poderá não ter acesso a alguns parâmetros se não estiverem incluídos nas permissões que lhe foram atribuídas. 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

Set-MailboxFolderPermission -Identity ayla@contoso.com:\Marketing -User ed@contoso.com -AccessRights Owner

Este exemplo substitui as permissões existentes do Ed para a pasta Marketing na caixa de correio do Ayla. O Ed recebe agora a função proprietário na pasta .

Exemplo 2

Set-MailboxFolderPermission -Identity ayla@contoso.com:\Calendar -User ed@contoso.com -AccessRights Editor -SharingPermissionFlags Delegate -SendNotificationToUser $true

No Exchange Online, este exemplo reenvia o convite de partilha para um delegado existente sem alterar as respetivas permissões efetivas (o Ed já é um delegado com permissões Editor para a caixa de correio do Ayla).

Exemplo 3

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

No Exchange Online, este exemplo remove o acesso a itens privados de um delegado existente.

Exemplo 4

Set-MailboxFolderPermission -Identity ayla@contoso.com:\Calendar -User ed@contoso.com -AccessRights Editor -SharingPermissionFlags None

No Exchange Online, este exemplo altera um delegado de calendário existente para Editor.

Exemplo 5

Set-MailboxFolderPermission -Identity ayla@contoso.com:\Calendar -User ed@contoso.com -AccessRights Editor

No Exchange Online, este exemplo altera as permissões de um utilizador existente para Editor sem alterar os respetivos status delegados atuais.

Exemplo 6

Set-MailboxFolderPermission -Identity ayla@contoso.com:\Calendar -User ed@contoso.com -AccessRights Editor -SendNotificationToUser $false

No Exchange Online, este exemplo altera as permissões de um utilizador existente para Editor e remove os respetivos status delegados atuais.

Parâmetros

-AccessRights

Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

O parâmetro AccessRights especifica as permissões que pretende modificar para o utilizador na pasta da caixa de correio. Os valores que especificar substituem as permissões existentes para o utilizador na pasta .

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 utilizador não tem acesso para ver ou interagir com a pasta ou o respetivo conteúdo.
  • CreateItems: o utilizador pode criar itens na pasta especificada.
  • CreateSubfolders: o utilizador pode criar subpastas na pasta especificada.
  • DeleteAllItems: o utilizador pode eliminar todos os itens na pasta especificada.
  • DeleteOwnedItems: o utilizador só pode eliminar itens que criou a partir da pasta especificada.
  • EditAllItems: o utilizador pode editar todos os itens na pasta especificada.
  • EditOwnedItems: o utilizador só pode editar itens que criou na pasta especificada.
  • FolderContact: o utilizador é o contacto da pasta pública especificada.
  • FolderOwner: o utilizador é o proprietário da pasta especificada. O utilizador pode ver a pasta, mover a pasta e criar subpastas. O usuário não pode ler, editar, excluir ou criar itens.
  • PastaVisível: o utilizador pode ver a pasta especificada, mas não consegue ler ou editar itens na pasta pública especificada.
  • ReadItems: o utilizador pode ler itens na 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
  • Contribuidor: 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: Ver apenas dados de disponibilidade
  • LimitedDetails: ver dados de disponibilidade com o assunto e a localização

Quando a função Editor é aplicada a pastas de calendário, os delegados podem aceitar ou recusar reuniões ao selecionar manualmente o pedido de reunião na caixa de correio. No Exchange Online, para enviar pedidos de reunião aos delegados onde possam aceitar ou recusar reuniões, utilize também o parâmetro SharingPermissionFlags com o valor Delegado.

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 Online

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, 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 confirmar 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

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 Online

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

Para o valor de MailboxID, pode utilizar qualquer valor que identifique exclusivamente a caixa de correio. Por exemplo:

  • Nome
  • Alias
  • Nome diferenciado (DN)
  • Nome diferenciado (DN)
  • Domínio\Nome de Utilizador
  • 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 pretende enviar um convite de partilha ao utilizador quando modifica as respetivas permissões de calendário. A mensagem é um convite de partilha de calendário normal que pode ser aceite pelo destinatário. Os valores válidos são:

  • $true: é enviado um convite de partilha.
  • $false: não é enviado nenhum convite de partilha. Este valor é a predefinição.

Este parâmetro aplica-se apenas a pastas de calendário e só pode ser utilizado com os seguintes valores de parâmetro AccessRights:

  • DisponibilidadeOnly
  • LimitedDetails
  • 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 delegado de calendário. Este parâmetro só se aplica a pastas de calendário e só pode ser utilizado quando o valor do parâmetro AccessRights é Editor. Os valores válidos são:

  • Nenhum: remove as permissões de delegado e atualiza a regra da mensagem de reunião para que o utilizador deixe de receber convites e respostas de reunião para a caixa de correio. Este valor é a predefinição quando utiliza o parâmetro SendNotificationToUser sem especificar um valor para o parâmetro SharingPermissionFlags.
  • Delegado: o utilizador é tornado delegado de calendário, o que inclui a receção de convites e respostas de reunião. Se não existirem outros delegados, este valor cria a regra de mensagem de reunião. Se existirem delegados, o utilizador é adicionado à regra da mensagem de reunião sem alterar a forma como as mensagens delegadas são enviadas.
  • CanViewPrivateItems: o utilizador pode aceder a itens privados no calendário. Tem de utilizar este valor com o valor Delegado.

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

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 Online

O parâmetro User especifica a caixa de correio, o usuário de email ou o grupo de segurança habilitado para email (entidade de segurança) que recebe a permissão para a pasta caixa de correio.

Para obter os melhores resultados, recomendamos que utilize os seguintes valores:

  • UPN: por exemplo, user@contoso.com (apenas utilizadores).
  • Domain\SamAccountName: por exemplo, contoso\user.

Caso contrário, pode utilizar qualquer valor que identifique exclusivamente o utilizador 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 Online

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.

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