Condividi tramite

Set-SiteMailboxProvisioningPolicy

Modulo:
Exchange PowerShell

Questo cmdlet è disponibile solo in Exchange locale.

Il cmdlet Set-SiteMailboxProvisioningPolicy consente di modificare un criterio di provisioning delle cassette postali del sito esistente.

Le cassette postali del sito sono state deprecate in Exchange Online e SharePoint Online nel 2017. Per altre informazioni, vedere Deprecazione delle cassette postali del sito.

Per informazioni sui set di parametri nella sezione Sintassi, vedere Sintassi del cmdlet di Exchange.

Sintassi

Default (impostazione predefinita). 

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

Descrizione

I criteri di provisioning della cassetta postale del sito applicano le impostazioni alle nuove cassette postali del sito che sono state create dall'utente. È possibile creare più criteri di provisioning per le cassette postali del sito ma verrà seguito solo quello predefinito quando gli utenti creano cassette postali del sito. Il criterio di provisioning predefinito per la cassetta postale del sito viene denominato Default.

È necessario disporre delle autorizzazioni prima di poter eseguire questo cmdlet. Anche se questo articolo elenca tutti i parametri per il cmdlet, è possibile che non si abbia accesso ad alcuni parametri se non sono inclusi nelle autorizzazioni assegnate all'utente. Per individuare le autorizzazioni necessarie per eseguire cmdlet o parametri nell'organizzazione, vedere Trovare le autorizzazioni necessarie per eseguire i cmdlet di Exchange.

Esempio

Esempio 1

Set-SiteMailboxProvisioningPolicy -Identity Default -MaxReceiveSize 25MB

Con questo esempio viene modificato il criterio di provisioning delle cassette postali denominato Default per impostare su 25 MB la dimensione massima di messaggi di posta elettronica che possono essere ricevuti dalla cassetta postale del sito.

Esempio 2

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

Con questo esempio vengono modificate la quota di avviso in 9,5 GB e la quota di invio e ricezione non consentiti in 10 GB.

Esempio 3

Set-SiteMailboxProvisioningPolicy -Identity SM_DefaultPolicy -AliasPrefix Project

In questo esempio viene creato il criterio di provisioning predefinito denominato SM_DefaultPolicy e il valore AliasPrefix viene impostato su Project. Quando si creano nuove cassette postali del sito, il prefisso Project- viene aggiunto automaticamente all'alias.

Parametri

-AliasPrefix

Applicabile: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

Il parametro AliasPrefix specifica il prefisso di testo personalizzato da aggiungere agli alias delle nuove cassette postali del sito. I valori validi sono:

  • Una stringa di testo con massimo 8 caratteri. Quando si specifica un valore di testo, il valore del parametro ignorato DefaultAliasPrefixEnabled e gli alias ottengono il prefisso di testo specificato.
  • Il valore $null. Questo valore è il valore predefinito. I risultati di questo valore dipendono dal valore del parametro DefaultAliasPrefixEnabled. Quando viene $true, gli alias ottengono il testo predefinito del prefisso. Quando viene $false, gli alias non ottengono testo di prefisso.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Confirm

Applicabile: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

L'opzione Confirm consente di specificare se visualizzare o nascondere la richiesta di conferma. L'impatto di questa opzione sul cmdlet dipende dalla richiesta di conferma del cmdlet prima di procedere.

  • I cmdlet distruttivi (ad esempio, i cmdlet Remove-*) dispongono di una pausa incorporata che impone all'utente di confermare il comando prima di procedere. Per questi cmdlet, è possibile ignorare la richiesta di conferma usando questa precisa sintassi: -Confirm:$false.
  • La maggior parte degli altri cmdlet (ad esempio, i cmdlet New-* e Set-*) non dispone di una pausa incorporata. Per questi cmdlet, specificando l'opzione Confirm senza un valore viene introdotta una pausa che impone all'utente di confermare il comando prima di procedere.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:cfr

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-DefaultAliasPrefixEnabled

Applicabile: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

Il parametro DefaultAliasPrefixEnabled consente di specificare se alle nuove cassette postali del sito è stato aggiunto il testo predefinito del prefisso all'alias. I valori validi sono:

  • $true: gli alias ottengono il testo del prefisso predefinito. Questo valore è il valore predefinito. In Microsoft 365 il testo del prefisso predefinito è SMO- (ad esempio, il valore BugBash_2016 alias diventa SMO-BugBash_2016). In Exchange locale il testo del prefisso predefinito è SM- (ad esempio, il valore BugBash_2016 alias diventa SM-BugBash_2016).
  • $false: gli alias non ottengono il testo predefinito del prefisso.

Il valore di questo parametro è correlato al valore del parametro AliasPrefix. Se si specifica una stringa di testo per AliasPrefix, il valore DefaultAliasPrefixEnabled viene ignorato. Se si specifica un valore di testo per AliasPrefix, il valore viene impostato automaticamente su $false, ma anche se viene impostato su $true, il testo del prefisso alias predefinito non viene usato.

Proprietà dei parametri

Tipo:Boolean
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-DomainController

Applicabile: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

Il parametro DomainController consente di specificare il controller di dominio utilizzato da questo cmdlet per la lettura o la scrittura dei dati in Active Directory. Identificare il controller di dominio mediante il relativo nome di dominio completo (FQDN). Ad esempio, dc01.contoso.com.

Proprietà dei parametri

Tipo:Fqdn
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Identity

Applicabile: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

Il parametro Identity consente di specificare l'identità del criterio di provisioning per la cassetta postale del sito da modificare. È possibile utilizzare qualsiasi valore che identifichi il criterio in modo univoco. Ad esempio:

  • Nome
  • Nome distinto (DN)
  • GUID

Proprietà dei parametri

Tipo:MailboxPolicyIdParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:1
Obbligatorio:True
Valore dalla pipeline:True
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-IsDefault

Applicabile: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

L'opzione IsDefault consente di specificare che il criterio di provisioning della cassetta postale del sito è quello predefinito. Con questa opzione non è necessario specificare alcun valore.

È possibile impostare più criteri ma verrà seguito solo quello predefinito quando gli utenti creano cassette postali del sito.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-IssueWarningQuota

Applicabile: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

Il parametro InternalFlags indica i passaggi facoltativi della richiesta. Questo parametro è utilizzato principalmente a fini di debug.

Un valore valido è un numero fino a 1,999999999999 terabyte (2199023254528 byte) o il valore illimitato. Un valore valido è un numero fino a 1.999999999 terabyte (2199023254528 byte) o il valore unlimited. Il valore predefinito è 20 gigabyte (21474836480 byte).

  • B (byte)
  • KB (kilobyte)
  • MB (megabyte)
  • GB (gigabyte)
  • TB (terabyte)

I valori non qualificati vengono in genere considerati come byte, ma i valori piccoli possono essere arrotondati per eccesso al kilobyte più vicino.

I valori non qualificati vengono in genere considerati byte, ma i valori bassi possono essere arrotondati al valore in kilobyte più vicino.

Il valore predefinito è 49 GB.

Proprietà dei parametri

Tipo:ByteQuantifiedSize
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-MaxReceiveSize

Applicabile: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

Il parametro MaxReceiveSize consente di specificare la dimensione massima dei messaggi che possono essere inviati alla cassetta postale del sito. I messaggi che superano la dimensione massima vengono rifiutati.

Nel caso venga immesso un valore, qualificarlo con una delle seguenti unità:

  • B (byte)
  • KB (kilobyte)
  • MB (megabyte)
  • GB (gigabyte)

I valori non qualificati vengono in genere considerati come byte, ma i valori piccoli possono essere arrotondati per eccesso al kilobyte più vicino.

Un valore valido corrisponde a un numero fino a 1,999999 GB (2147482624 byte) o al valore unlimited. Il valore predefinito è 36 MB.

Proprietà dei parametri

Tipo:ByteQuantifiedSize
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Name

Applicabile: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

Il parametro Name consente di specificare il nome univoco del criterio di provisioning della cassetta postale del sito. La lunghezza massima è 64 caratteri. Se il valore contiene degli spazi, è necessario racchiuderlo tra virgolette (").

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-ProhibitSendReceiveQuota

Applicabile: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

Il parametro ProhibitSendReceiveQuota specifica un limite di dimensioni per la cassetta postale. Se la cassetta postale raggiunge o supera queste dimensioni, la cassetta postale non può inviare o ricevere nuovi messaggi. I messaggi inviati alla cassetta postale vengono restituiti al mittente con un messaggio di errore descrittivo. Questo valore determina in modo efficace le dimensioni massime della cassetta postale.

Un valore valido è un numero fino a 1,999999999999 terabyte (2199023254528 byte) o il valore illimitato. Un valore valido è un numero fino a 1.999999999 terabyte (2199023254528 byte) o il valore unlimited. Il valore predefinito è 20 gigabyte (21474836480 byte).

  • B (byte)
  • KB (kilobyte)
  • MB (megabyte)
  • GB (gigabyte)
  • TB (terabyte)

I valori non qualificati vengono in genere considerati come byte, ma i valori piccoli possono essere arrotondati per eccesso al kilobyte più vicino.

Il valore deve essere maggiore o uguale ai valori ProhibitSendQuota o IssueWarningQuota.

Il valore predefinito è 50 GB.

Proprietà dei parametri

Tipo:ByteQuantifiedSize
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-WhatIf

Applicabile: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

L'opzione WhatIf consente di simulare le azioni del comando. È possibile utilizzare tale opzione per visualizzare le modifiche che verrebbero applicate senza effettivamente applicarle. Con questa opzione non è necessario specificare alcun valore.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:Wi

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

CommonParameters

Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedere about_CommonParameters.

Input

Input types

Per verificare i tipi di input accettati da questo cmdlet, vedere Tipi di input e output dei cmdlet. Se il campo relativo al tipo di input di un cmdlet è vuoto, il cmdlet non accetta dati di input.

Output

Output types

Per verificare i tipi restituiti, detti anche tipi di output, accettati da questo cmdlet, vedere Tipi di input e output dei cmdlet. Se il campo relativo al tipo di output è vuoto, il cmdlet non restituisce dati.