Set-SiteMailboxProvisioningPolicy

Este cmdlet está disponível somente no Exchange local.

Use o cmdlet Set-SiteMailboxProvisioningPolicy para modificar uma política existente de provisionamento de caixas de correio locais.

As caixas de correio de site foram preteridas no Exchange Online e no SharePoint Online em 2017. Para obter mais informações, consulte Preterição de Caixas de Correio de Sites.

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

Sintaxe

Default (Default)

Set-SiteMailboxProvisioningPolicy
    [-Identity] <MailboxPolicyIdParameter>
    [-AliasPrefix <String>]
    [-Confirm]
    [-DefaultAliasPrefixEnabled <Boolean>]
    [-DomainController <Fqdn>]
    [-IsDefault]
    [-IssueWarningQuota <ByteQuantifiedSize>]
    [-MaxReceiveSize <ByteQuantifiedSize>]
    [-Name <String>]
    [-ProhibitSendReceiveQuota <ByteQuantifiedSize>]
    [-WhatIf]
    [<CommonParameters>]

Description

As políticas de provisionamento de caixa de correio de site aplicam configurações a novas caixas de correio de site criadas por você. Você pode criar várias políticas de provisionamento de caixa de correio do site, mas apenas a política padrão é seguida quando os usuários criam caixas de correio. A política de provisionamento de caixa de correio de site padrão é chamada Padrão.

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-SiteMailboxProvisioningPolicy -Identity Default -MaxReceiveSize 25MB

Este exemplo altera a política de provisionamento de caixas de correio locais chamado Padrão para permitir que o tamanho máximo das mensagens de email que podem ser recebidas pela caixa de correio local seja 25 MB.

Exemplo 2

Set-SiteMailboxProvisioningPolicy -Identity Default -IssueWarningQuota 9GB -ProhibitSendReceiveQuota 10GB

Este exemplo altera a cota de alerta para 9,5 GB e a proibição da quota de envio e de recebimento para 10 GB.

Exemplo 3

Set-SiteMailboxProvisioningPolicy -Identity SM_DefaultPolicy -AliasPrefix Project

Este exemplo muda a política de provisionamento padrão SM_DefaultPolicy e define o valor de AliasPrefix como Project. Quando você cria novas caixas de correio de site, o prefixo Project- é adicionado automaticamente ao alias.

Parâmetros

-AliasPrefix

Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

O parâmetro AliasPrefix especifica o prefixo de texto personalizado para adicionar aos aliases das novas caixas de correio do site. Os valores válidos são:

  • Uma cadeia de caracteres de texto que tenha 8 caracteres ou menos. Quando você especifica um valor de texto, o valor do parâmetro DefaultAliasPrefixEnabled ignorado e os aliases recebem o prefixo de texto especificado por você.
  • O valor $null. Esse valor é o padrão. Os resultados desse valor dependem do valor do parâmetro DefaultAliasPrefixEnabled. Quando é $true, os aliases obtêm o texto de prefixo padrão. Quando é $false, os aliases não recebem nenhum texto de prefixo.

Propriedades do parâmetro

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

-Confirm

Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

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

-DefaultAliasPrefixEnabled

Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

O parâmetro DefaultAliasPrefixEnabled especifica se as novas caixas de correio de site têm o texto de prefixo padrão adicionado ao alias. Os valores válidos são:

  • $true: Os aliases obtêm o texto de prefixo padrão. Esse valor é o padrão. No Microsoft 365, o texto de prefixo padrão é SMO- (por exemplo, o valor BugBash_2016 do alias torna-se SMO-BugBash_2016). No Exchange local, o texto de prefixo padrão é SM- (por exemplo, o valor BugBash_2016 do alias torna-se SM-BugBash_2016).
  • $false: aliases não obtêm o texto de prefixo padrão.

O valor deste parâmetro está relacionado ao valor do parâmetro AliasPrefix. Se você especificar uma cadeia de caracteres de texto para AliasPrefix, o valor DefaultAliasPrefixEnabled será ignorado. Especificar um valor de texto padrão para AliasPrefix define o valor automaticamente como $false, mas, mesmo se você definir como $true, o prefixo de texto padrão do alias não é usado.

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

-DomainController

Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

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

O parâmetro Identity especifica a identidade da política de provisionamento de caixas de correio locais que você deseja editar. É possível usar qualquer valor que identifique a política com exclusividade. Por exemplo:

  • Nome
  • DN (nome diferenciado)
  • GUID

Propriedades do parâmetro

Tipo:MailboxPolicyIdParameter
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 Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

A opção IsDefault especifica que a política de provisionamento de caixas de correio locais é a política padrão. Não é preciso especificar um valor com essa opção.

Você pode ter várias políticas, mas apenas a política padrão é seguida quando os usuários criam caixas de correio locais.

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

O parâmetro InternalFlags especifica os passos opcionais na solicitação. 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 padrão é 49 GB.

Propriedades do parâmetro

Tipo:ByteQuantifiedSize
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 Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

O parâmetro MaxReceiveSize especifica o tamanho máximo de uma mensagem que pode ser enviada para a caixa de correio do site. 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)
  • GB (gigabytes)

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 até 1,999999 gigabytes (2147482624 bytes) ou o valor unlimited. O valor padrão é 36 MB.

Propriedades do parâmetro

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

-Name

Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

O parâmetro Name especifica o nome exclusivo da política de provisionamento de caixa de correio do site. O tamanho máximo é de 64 caracteres. Se o valor contiver espaços, coloque-o entre aspas (").

Propriedades do parâmetro

Tipo:String
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 Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

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 padrão é 50 GB.

Propriedades do parâmetro

Tipo:ByteQuantifiedSize
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 Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

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.