Compartilhar via

New-SiteMailboxProvisioningPolicy

Módulo:
Exchange PowerShell

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

Use o cmdlet New-SiteMailboxProvisioningPolicy para criar políticas de provisionamento para caixas de correio de site.

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

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

Sintaxe

Default (Padrão) 

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

Description

As caixas de correio do site permitem o acesso a documentos do Microsoft SharePoint e ao e-mail do Exchange através da mesma interface de cliente. 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, 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

New-SiteMailboxProvisioningPolicy -Name SM_ProvisioningPolicy -IsDefault -IssueWarningQuota 9GB -ProhibitSendReceiveQuota 10GB -MaxReceiveSize 50MB

Este exemplo cria a política de provisionamento padrão SM_ProvisioningPolicy que possui as seguintes configurações:

  • A cota de aviso para as caixas de correio do site é 9 GB.
  • As caixas de correio do site estão proibidas de receber mensagens quando o tamanho da caixa de correio chega a 10 GB.
  • O tamanho máximo das mensagens de email que podem ser enviadas para as caixas de correio do site é de 50 MB.

Exemplo 2

New-SiteMailboxProvisioningPolicy -Name SM_DefaultPolicy -IsDefault

Este exemplo cria uma política de provisionamento padrão SM_DefaultPolicy que usa os padrões para enviar e receber cotas.

Exemplo 3

New-SiteMailboxProvisioningPolicy -Name SM_DefaultPolicy -IsDefault -AliasPrefix Project

Este exemplo altera 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

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. Este valor é a predefinição. Os resultados deste valor dependem do valor do parâmetro DefaultAliasPrefixEnabled. Quando estiver $true, os aliases obtêm o texto predefinido do prefixo. Quando é $false, os aliases não obtêm 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

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

-DefaultAliasPrefixEnabled

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

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

  • $true: os aliases obtêm o texto predefinido do prefixo. Este valor é a predefinição. No Microsoft 365, o texto predefinido do prefixo é SMO- (por exemplo, o valor BugBash_2016 de alias SMO-BugBash_2016torna-se ). No Exchange no local, o texto predefinido do prefixo é SM- (por exemplo, o valor BugBash_2016 de alias SM-BugBash_2016torna-se ).
  • $false: os aliases não obtêm o texto predefinido do prefixo.

O valor deste parâmetro está relacionado ao valor do parâmetro AliasPrefix. Se especificar uma cadeia de texto para AliasPrefix, o valor DefaultAliasPrefixEnabled é 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

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

-IsDefault

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

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

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,99999999999 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)

Os valores não qualificados são normalmente tratados como bytes, mas os valores pequenos podem ser arredondados até ao quilobyte 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

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)

Os valores não qualificados são normalmente tratados como bytes, mas os valores pequenos podem ser arredondados até ao quilobyte 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

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:1
Obrigatório:True
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

O parâmetro ProhibitSendReceiveQuota especifica um limite de tamanho para a caixa de correio. Se a caixa de correio atingir ou exceder este tamanho, a caixa de correio não pode enviar ou receber novas mensagens. As mensagens enviadas para a caixa de correio são devolvidas ao remetente com uma mensagem de erro descritiva. Este valor determina efetivamente o tamanho máximo da caixa de correio.

Um valor válido é um número até 1,99999999999 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)

Os valores não qualificados são normalmente tratados como bytes, mas os valores pequenos podem ser arredondados até ao quilobyte mais próximo.

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

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.