Set-MailboxPlan

Módulo:
Exchange PowerShell

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.

Sintaxe

Default (Default) 

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 quando você se inscreve no serviço e pela 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, o que aplica 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 para Cliente) correspondente com o mesmo nome e valor de 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 pode 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 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

Set-MailboxPlan -Identity ExchangeOnlineEnterprise -ProhibitSendReceiveQuota 40GB -ProhibitSendQuota 39.5GB -IssueWarningQuota 39GB

Este exemplo reduz as cotas de caixa de correio padrão no plano de caixa de correio chamado ExchangeOnlineEnterprise.

Parâmetros

-Confirm

Aplicável: Exchange Online, complemento de segurança interno para caixas de correio locais

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

-Force

Aplicável: Exchange Online

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.

Propriedades do parâmetro

Tipo:SwitchParameter
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 Online, complemento de segurança interno para caixas de correio locais

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

Propriedades do parâmetro

Tipo:MailboxPlanIdParameter
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

-IsDefault

Aplicável: Exchange Online

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.

As caixas de correio novas e recém-habilitadas recebem as configurações do plano de caixa de correio padrão.

Propriedades do parâmetro

Tipo:SwitchParameter
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

-IssueWarningQuota

Aplicável: Exchange Online

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 de até 1,999999999 terabytes (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)

Valores não qualificados normalmente são tratados como bytes, mas valores pequenos podem ser arredondados para cima para o kilobyte mais próximo.

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. Você pode diminuir o valor e aumentar o valor, mas não pode exceder o valor máximo especificado pela assinatura ou licença que corresponde ao plano de caixa de correio.

Propriedades do parâmetro

Tipo:Unlimited
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

-MaxReceiveSize

Aplicável: Exchange Online

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)

Valores não qualificados normalmente são tratados como bytes, mas valores pequenos podem ser arredondados para cima para o kilobyte mais próximo.

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). Você pode diminuir o valor e aumentar o valor, mas não pode exceder o valor máximo especificado pela assinatura ou licença que corresponde ao plano de caixa de correio.

Use esse parâmetro para alterar o valor MaxReceiveSize para as novas caixas de correio que você criar. Use o parâmetro MaxReceiveSize no cmdlet Set-Mailbox para configurar o valor nas caixas de correio existentes.

A codificação Base64 aumenta o tamanho das mensagens em aproximadamente 33%, então especifique um valor 33% maior do que o tamanho máximo de mensagem real que você deseja impor. Por exemplo, o valor de 64 MB resulta em um tamanho máximo de mensagem de aproximadamente 48 MB.

Propriedades do parâmetro

Tipo:Unlimited
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

-MaxSendSize

Aplicável: Exchange Online

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)

Valores não qualificados normalmente são tratados como bytes, mas valores pequenos podem ser arredondados para cima para o kilobyte mais próximo.

Um valor válido é um número de até 150 MB. O valor padrão é 35 MB.

O valor máximo é determinado pelo plano de caixa de correio (assinaturas e licenças). Você pode diminuir o valor e aumentar o valor, mas não pode exceder o valor máximo especificado pela assinatura ou licença que corresponde ao plano de caixa de correio.

Use esse parâmetro para alterar o valor MaxSendSize para as novas caixas de correio que você criar. Use o parâmetro MaxSendSize no cmdlet Set-Mailbox para configurar o valor nas caixas de correio existentes.

A codificação Base64 aumenta o tamanho das mensagens em aproximadamente 33%, então especifique um valor 33% maior do que o tamanho máximo de mensagem real que você deseja impor. Por exemplo, o valor de 64 MB resulta em um tamanho máximo de mensagem de aproximadamente 48 MB.

Propriedades do parâmetro

Tipo:Unlimited
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

-ProhibitSendQuota

Aplicável: Exchange Online

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 de até 1,999999999 terabytes (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)

Valores não qualificados normalmente são tratados como bytes, mas valores pequenos podem ser arredondados para cima para o kilobyte mais próximo.

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. Você pode diminuir o valor e aumentar o valor, mas não pode exceder o valor máximo especificado pela assinatura ou licença que corresponde ao plano de caixa de correio.

Propriedades do parâmetro

Tipo:Unlimited
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

-ProhibitSendReceiveQuota

Aplicável: Exchange Online

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 de até 1,999999999 terabytes (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)

Valores não qualificados normalmente são tratados como bytes, mas valores pequenos podem ser arredondados para cima para o kilobyte mais próximo.

O valor deve ser maior ou igual aos valores de 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.

Propriedades do parâmetro

Tipo:Unlimited
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

-RecipientLimits

Aplicável: Exchange Online

Esse parâmetro está reservado para uso interno da Microsoft.

Propriedades do parâmetro

Tipo:Unlimited
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

-RetainDeletedItemsFor

Aplicável: Exchange Online

O parâmetro RetainDeletedItemsFor especifica o período de tempo para manter os itens excluídos temporariamente para a caixa de correio. Itens excluídos temporariamente são itens que foram excluídos usando qualquer um destes 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 do item excluído expire, os usuários podem recuperar itens excluídos temporariamente no Outlook e no 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 é 14 dias (14.00:00:00). No Exchange Online, você pode aumentar o valor para um máximo de 30 dias.

Propriedades do parâmetro

Tipo:EnhancedTimeSpan
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

-RetentionPolicy

Aplicável: Exchange Online

O parâmetro RetentionPolicy especifica a política de retenção aplicada às 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 é denominada Política 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 este 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 as licenças. Você precisa redefinir manualmente a RetentionPolicy para o valor original.
  • As alterações na política de retenção padrão que afetam as caixas de correio existentes podem saturar a rede se houver centenas ou milhares de caixas de correio que exijam atualizações.

Para obter mais informações, consulte Planos de caixa de correio no Exchange Online.

Propriedades do parâmetro

Tipo:MailboxPolicyIdParameter
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

-RoleAssignmentPolicy

Aplicável: Exchange Online

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.

Propriedades do parâmetro

Tipo:MailboxPolicyIdParameter
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

-WhatIf

Aplicável: Exchange Online, complemento de segurança interno para caixas de correio locais

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.