Set-MailboxPlan
Esse cmdlet só está disponível no serviço baseado em nuvem.
Use o cmdlet Set-MailboxPlan para modificar as configurações de planos de caixa de correio do serviço baseado na nuvem.
Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.
Syntax
Set-MailboxPlan
[-Identity] <MailboxPlanIdParameter>
[-Confirm]
[-Force]
[-IsDefault]
[-IssueWarningQuota <Unlimited>]
[-MaxReceiveSize <Unlimited>]
[-MaxSendSize <Unlimited>]
[-ProhibitSendQuota <Unlimited>]
[-ProhibitSendReceiveQuota <Unlimited>]
[-RecipientLimits <Unlimited>]
[-RetainDeletedItemsFor <EnhancedTimeSpan>]
[-RetentionPolicy <MailboxPolicyIdParameter>]
[-RoleAssignmentPolicy <MailboxPolicyIdParameter>]
[-WhatIf]
[<CommonParameters>] Description
Um plano de caixa de correio é um modelo que configura automaticamente as propriedades da caixa de correio. Os planos de caixa de correio correspondem aos tipos de licença e são aplicados quando você licencia o usuário. A disponibilidade de um plano de caixa de correio é determinada por suas seleções ao se inscrever no serviço e na idade da sua organização.
Modificar as configurações em um plano de caixa de correio não afeta as caixas de correio existentes que foram criadas usando o plano de caixa de correio. A única maneira de usar um plano de caixa de correio para modificar as configurações em uma caixa de correio existente é atribuir uma licença diferente ao usuário, que aplicará o plano de caixa de correio correspondente à caixa de correio.
Cada plano de caixa de correio tem um plano de caixa de correio CAS (Serviços de Acesso ao Cliente) correspondente com o mesmo nome e o valor do nome de exibição. Você pode usar o cmdlet Set-CasMailboxPlan para habilitar ou desabilitar o acesso POP3, IMAP4 ou Exchange ActiveSync (EAS) a caixas de correio novas ou recém-habilitadas e especificar a política de caixa de correio Outlook na Web (anteriormente conhecida como Outlook Web App) para as caixas de correio.
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
Set-MailboxPlan -Identity ExchangeOnlineEnterprise -ProhibitSendReceiveQuota 40GB -ProhibitSendQuota 39.5GB -IssueWarningQuota 39GBEste exemplo reduz as cotas de caixa de correio padrão no plano de caixa de correio chamado ExchangeOnlineEnterprise.
Parâmetros
-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 Online, Exchange Online Protection |
-Force
A opção Forçar oculta mensagens de aviso ou confirmação. Não é preciso especificar um valor com essa opção.
Você pode usar essa opção para executar tarefas de modo programático onde a solicitação por entrada administrativa é inadequada.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-Identity
O parâmetro Identity especifica o plano de caixa de correio que você deseja modificar. É possível usar qualquer valor que identifique o plano de caixa de correio com exclusividade. Por exemplo:
- Nome
- Alias
- Nome para exibição
- DN (nome diferenciado)
- GUID
| Type: | MailboxPlanIdParameter |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-IsDefault
A opção IsDefault indica que o plano de caixa de correio é o plano de caixa de correio padrão. Não é preciso especificar um valor com essa opção.
Caixas de correio novas e recém-habilitadas recebem as configurações no plano de caixa de correio padrão.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-IssueWarningQuota
O parâmetro IssueWarningQuota especifica o limite de aviso para o tamanho das caixas de correio criadas ou habilitadas usando o plano de caixa de correio. Esse parâmetro é usado principalmente para fins de depuração.
Um valor válido é um número até 1.999999999999 (2199023254528 bytes) ou o valor ilimitado. Um valor válido é um número até 1,999999999 terabytes (2199023254528 bytes) ou o valor unlimited. O valor padrão é 20 gigabytes (21474836480 bytes).
- B (bytes)
- KB (quilobytes)
- MB (megabytes)
- GB (gigabytes)
- TB (terabytes)
TB (terabytes)
Os valores não qualificados geralmente são tratados como bytes, mas valores pequenos podem ser arredondados para o quilobyte mais próximo.
O valor máximo é determinado pelo plano de caixa de correio. É possível reduzir e elevar o valor, mas não será possível ultrapassar o valor máximo especificado pela assinatura ou pela licença correspondente ao plano de caixa de correio.
| Type: | Unlimited |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-MaxReceiveSize
O parâmetro MaxReceiveSize especifica o tamanho máximo de uma mensagem que pode ser enviada para a caixa de correio. Mensagens maiores do que o tamanho máximo serão rejeitadas.
Um valor válido é um número até 1,999999999 terabytes (2199023254528 bytes) ou o valor unlimited. O valor padrão é 6 gigabytes (6442450944 bytes).
- B (bytes)
- KB (quilobytes)
- MB (megabytes)
TB (terabytes)
Um valor válido é um número de até 150 MB. O valor padrão é 36 MB.
O valor máximo é determinado pelo plano de caixa de correio (assinaturas e licenças). É possível reduzir e elevar o valor, mas não será possível ultrapassar o valor máximo especificado pela assinatura ou pela licença correspondente ao plano de caixa de correio.
Use esse parâmetro para alterar o valor MaxReceiveSize para novas caixas de correio que você cria. Use o parâmetro MaxReceiveSize no cmdlet Set-Mailbox para configurar o valor em caixas de correio existentes.
A codificação base64 aumenta o tamanho das mensagens em aproximadamente 33%, portanto, especifique um valor 33% maior que o tamanho máximo real da mensagem que você deseja impor. Por exemplo, o valor de 64 MB resulta em um tamanho máximo de mensagem de aproximadamente 48 MB.
| Type: | Unlimited |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-MaxSendSize
O parâmetro MaxSendSize especifica o tamanho máximo de uma mensagem que pode ser enviada pela caixa de correio.
Um valor válido é um número até 1,999999999 terabytes (2199023254528 bytes) ou o valor unlimited. O valor padrão é 6 gigabytes (6442450944 bytes).
- B (bytes)
- KB (quilobytes)
- MB (megabytes)
TB (terabytes)
Um valor válido é um número de até 150 MB. O valor padrão é de 35 MB.
O valor máximo é determinado pelo plano de caixa de correio (assinaturas e licenças). É possível reduzir e elevar o valor, mas não será possível ultrapassar o valor máximo especificado pela assinatura ou pela licença correspondente ao plano de caixa de correio.
Use esse parâmetro para alterar o valor MaxSendSize para novas caixas de correio que você cria. Use o parâmetro MaxSendSize no cmdlet Set-Mailbox para configurar o valor em caixas de correio existentes.
A codificação base64 aumenta o tamanho das mensagens em aproximadamente 33%, portanto, especifique um valor 33% maior que o tamanho máximo real da mensagem que você deseja impor. Por exemplo, o valor de 64 MB resulta em um tamanho máximo de mensagem de aproximadamente 48 MB.
| Type: | Unlimited |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-ProhibitSendQuota
Se você modificar o valor de prioridade de uma regra, a posição da regra na lista mudará para corresponder ao valor de prioridade especificado. Em outras palavras, se você definir o valor de prioridade de uma regra para o mesmo valor de uma regra existente, o valor de prioridade da regra existente e de todas as outras regras de prioridade mais baixas depois dele será aumentado em 1.
Um valor válido é um número até 1.999999999999 (2199023254528 bytes) ou o valor ilimitado. Um valor válido é um número até 1,999999999 terabytes (2199023254528 bytes) ou o valor unlimited. O valor padrão é 20 gigabytes (21474836480 bytes).
- B (bytes)
- KB (quilobytes)
- MB (megabytes)
- GB (gigabytes)
- TB (terabytes)
TB (terabytes)
Os valores não qualificados geralmente são tratados como bytes, mas valores pequenos podem ser arredondados para o quilobyte mais próximo.
O valor máximo é determinado pelo plano de caixa de correio. É possível reduzir e elevar o valor, mas não será possível ultrapassar o valor máximo especificado pela assinatura ou pela licença correspondente ao plano de caixa de correio.
| Type: | Unlimited |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-ProhibitSendReceiveQuota
O parâmetro ProhibitSendReceiveQuota especifica um limite de tamanho para a caixa de correio. Se a caixa de correio atingir ou exceder esse tamanho, a caixa de correio não poderá enviar ou receber novas mensagens. As mensagens enviadas para a caixa de correio são retornadas ao remetente com uma mensagem de erro descritiva. Esse valor determina efetivamente o tamanho máximo da caixa de correio.
Um valor válido é um número até 1.999999999999 (2199023254528 bytes) ou o valor ilimitado. Um valor válido é um número até 1,999999999 terabytes (2199023254528 bytes) ou o valor unlimited. O valor padrão é 20 gigabytes (21474836480 bytes).
- B (bytes)
- KB (quilobytes)
- MB (megabytes)
- GB (gigabytes)
- TB (terabytes)
TB (terabytes)
O valor deve ser maior ou igual aos valores ProhibitSendQuota ou IssueWarningQuota.
O valor máximo é determinado pelo plano de caixa de correio. É possível reduzir o valor, mas não será possível ultrapassar o valor máximo especificado pela assinatura ou pela licença correspondente ao plano de caixa de correio.
| Type: | Unlimited |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-RecipientLimits
Esse parâmetro está reservado para uso interno da Microsoft.
| Type: | Unlimited |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-RetainDeletedItemsFor
O parâmetro RetainDeletedItemsFor especifica o tempo para manter itens excluídos suavemente para a caixa de correio. Itens excluídos com exclusão suave são itens que foram excluídos usando qualquer um desses métodos:
- O parâmetro RetainDeletedItemsFor especifica por quanto tempo manter itens excluídos por software para a caixa de correio. Os itens excluídos por software são aqueles que foram excluídos usando um destes métodos:
- Exclusão de itens da pasta Itens Excluídos.
- Seleção da ação Esvaziar Pastas Itens Excluídos.
Exclusão de itens usando Shift + Delete.
Antes que o período de retenção de item excluído expire, os usuários podem recuperar itens excluídos no Outlook e Outlook na Web usando o recurso Recuperar Itens Excluídos. Para obter mais informações, consulte Pasta Itens Recuperáveis no Exchange Online.
Para especificar um valor, insira-o como um período de tempo: dd.hh:mm:ss em que dd = dias, hh = horas, mm = minutos e ss = segundos.
O valor padrão é de 14 dias (14.00:00:00). Em Exchange Online, você pode aumentar o valor para um máximo de 30 dias.
| Type: | EnhancedTimeSpan |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-RetentionPolicy
O parâmetro RetentionPolicy especifica a política de retenção aplicada a novas caixas de correio que você cria. É possível usar qualquer valor que identifique a política com exclusividade. Por exemplo:
- Nome
- DN (nome diferenciado)
- GUID
As diretivas de retenção consistem em marcas aplicadas a pastas da caixa de correio e itens de email para determinar o período de tempo durante o qual os itens devem ser retidos. Use o cmdlet Get-RetentionPolicy para ver as políticas de retenção disponíveis.
Por padrão, o valor desse parâmetro está em branco ($null), o que significa que a política de retenção padrão (a política de retenção em que o valor da propriedade IsDefault é True) é atribuída a novas caixas de correio. Por padrão, a política de retenção padrão é chamada de Política de MRM Padrão.
Se você não definir um valor para esse parâmetro, as caixas de correio existentes também serão atualizadas se você alterar qual política de retenção é o padrão usando a opção IsDefault nos cmdlets New-RetentionPolicy ou Set-RetentionPolicy.
Observação: especificar um valor para esse parâmetro tem os seguintes problemas potenciais:
- Se o valor desse parâmetro não estiver em branco ($null), a política de retenção especificada deverá ser a política de retenção padrão do Exchange configurada para a organização. Caso contrário, a experiência pode ser inconsistente ao criar novas caixas de correio, habilitar caixas de correio desabilitadas e alterar licenças.
- Se uma caixa de correio receber uma política de retenção do Exchange que não seja a política padrão, o valor RetentionPolicy da caixa de correio será substituído ao alterar licenças e precisará ser redefinido manualmente para o valor original.
- Alterações na política de retenção padrão que afetam as caixas de correio existentes podem potencialmente saturar a rede se houver centenas ou milhares de caixas de correio que exigem atualizações.
Para obter mais informações, consulte Planos de caixa de correio em Exchange Online.
| Type: | MailboxPolicyIdParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-RoleAssignmentPolicy
O parâmetro RoleAssignmentPolicy especifica a política de atribuição de função aplicada à caixa de correio. Você pode usar qualquer valor que identifique a política de atribuição de função de forma exclusiva. Por exemplo:
- Nome
- DN (nome diferenciado)
- GUID
O valor padrão é a Política de Atribuição de Função Padrão.
Para ver as políticas de atribuição de função disponíveis, use o cmdlet Get-RoleAssignmentPolicy.
| Type: | MailboxPolicyIdParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | 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 Online, Exchange Online Protection |
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.
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de