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 do site foram preteridas no Exchange Online e no SharePoint Online em 2017. Para obter mais informações, confira Preterir caixas de correio do site.

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

Syntax

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 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-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 do site, o prefixo Project- é adicionado automaticamente ao alias.

Parâmetros

-AliasPrefix

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 é o valor 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.
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

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

-DefaultAliasPrefixEnabled

O parâmetro DefaultAliasPrefixEnabled especifica se novas caixas de correio do 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 é o valor padrão. No Microsoft 365, o texto de prefixo padrão é SMO- (por exemplo, o valor BugBash_2016 do alias se torna SMO-BugBash_2016). No Exchange local, o texto de prefixo padrão é SM- (por exemplo, o valor BugBash_2016 do alias se torna SM-BugBash_2016).
  • $false: os aliases não recebem 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.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-DomainController

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.

Type:Fqdn
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Identity

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
Type:MailboxPolicyIdParameter
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-IsDefault

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.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-IssueWarningQuota

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

Type:ByteQuantifiedSize
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-MaxReceiveSize

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)

TB (terabytes)

Um valor válido é um número até 1,999999 gigabytes (2147482624 bytes) ou o valor unlimited. O valor padrão é 36 MB.

Type:ByteQuantifiedSize
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Name

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 (").

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

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

Type:ByteQuantifiedSize
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

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

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.