Set-EmailAddressPolicy
Questo cmdlet è disponibile in Exchange locale e nel servizio basato su cloud. Alcuni parametri e impostazioni possono essere esclusivi di singoli ambienti.
Usare il cmdlet Set-EmailAddressPolicy per modificare i criteri degli indirizzi di posta elettronica. In Exchange Online, i criteri degli indirizzi di posta elettronica sono disponibili solo per Gruppi di Microsoft 365.
Per informazioni sui set di parametri nella sezione Sintassi, vedere Sintassi del cmdlet di Exchange.
Sintassi
Set-EmailAddressPolicy
[-Identity] <EmailAddressPolicyIdParameter>
[-ConditionalCompany <MultiValuedProperty>]
[-ConditionalCustomAttribute1 <MultiValuedProperty>]
[-ConditionalCustomAttribute10 <MultiValuedProperty>]
[-ConditionalCustomAttribute11 <MultiValuedProperty>]
[-ConditionalCustomAttribute12 <MultiValuedProperty>]
[-ConditionalCustomAttribute13 <MultiValuedProperty>]
[-ConditionalCustomAttribute14 <MultiValuedProperty>]
[-ConditionalCustomAttribute15 <MultiValuedProperty>]
[-ConditionalCustomAttribute2 <MultiValuedProperty>]
[-ConditionalCustomAttribute3 <MultiValuedProperty>]
[-ConditionalCustomAttribute4 <MultiValuedProperty>]
[-ConditionalCustomAttribute5 <MultiValuedProperty>]
[-ConditionalCustomAttribute6 <MultiValuedProperty>]
[-ConditionalCustomAttribute7 <MultiValuedProperty>]
[-ConditionalCustomAttribute8 <MultiValuedProperty>]
[-ConditionalCustomAttribute9 <MultiValuedProperty>]
[-ConditionalDepartment <MultiValuedProperty>]
[-ConditionalStateOrProvince <MultiValuedProperty>]
[-Confirm]
[-DisabledEmailAddressTemplates <ProxyAddressTemplateCollection>]
[-DomainController <Fqdn>]
[-EnabledEmailAddressTemplates <ProxyAddressTemplateCollection>]
[-EnabledPrimarySMTPAddressTemplate <String>]
[-ForceUpgrade]
[-IncludedRecipients <WellKnownRecipientType>]
[-Name <String>]
[-Priority <EmailAddressPolicyPriority>]
[-RecipientContainer <OrganizationalUnitIdParameter>]
[-RecipientFilter <String>]
[-WhatIf]
[<CommonParameters>]
Descrizione
Dopo aver usato il cmdlet Set-EmailAddressPolicy per modificare i criteri degli indirizzi di posta elettronica in un'organizzazione di Exchange locale, è necessario usare il cmdlet Update-EmailAddressPolicy per applicare i criteri aggiornati ai destinatari.
I parametri Conditional utilizzati con il parametro IncludedRecipients sono soggetti alle limitazioni seguenti:
- L'operatore EQV viene utilizzato per ogni valore della proprietà, come in "Department equals Sales". Non sono supportati i caratteri jolly e le corrispondenze parziali.
- L'operatore OR viene sempre utilizzato per più valori della stessa proprietà, come in "Department equals Sales OR Marketing".
- L'operatore AND viene sempre utilizzato per più proprietà, come in "Department equals Sales AND Company equals Contoso".
Per creare filtri flessibili che usano qualsiasi proprietà del destinatario disponibile e che non sono soggetti a queste limitazioni, è possibile usare il parametro RecipientFilter per creare un filtro OPATH personalizzato.
Non è possibile usare questo cmdlet per sostituire un filtro pre-analizzato con un filtro OPATH personalizzato o viceversa. È possibile modificare solo il filtro esistente.
È necessario disporre delle autorizzazioni prima di poter eseguire questo cmdlet. Sebbene in questo argomento vengano elencati tutti i parametri relativi al cmdlet, si potrebbe non avere accesso ad alcuni di essi qualora non siano inclusi nelle autorizzazioni assegnate. 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-EmailAddressPolicy -Identity "Southeast Executives" -ConditionalStateOrProvince @{Add="TX"}
In Exchange locale questo esempio modifica i criteri di indirizzo di posta elettronica esistenti denominati Southeast Executives aggiungendo il valore di Stato o provincia TX (Texas) al filtro destinatario pre-analizzato.
Esempio 2
Set-EmailAddressPolicy -Identity "Contoso Corp" -DisabledEmailAddressTemplates $null
In Exchange locale questo esempio cancella i modelli di indirizzo di posta elettronica disabilitati dal criterio indirizzo di posta elettronica denominato Contoso Corp.
Esempio 3
Set-EmailAddressPolicy -Identity "Office 365 Groups" -EnabledEmailAddressTemplates "SMTP:@contoso.com","smtp:@contoso.onmicrosoft.com","smtp:@contoso.microsoftonline.com"
In Exchange Online questo esempio modifica il criterio di accesso alla posta elettronica esistente denominato "Office 365 Groups" e imposta i modelli di indirizzo di posta elettronica abilitati in modo che utilizzino "@contoso.com" come indirizzo SMTP primario e "@contoso.onmicrosoft.com" e "@contoso.microsoftonline.com" come indirizzi proxy.
Parametri
-ConditionalCompany
Questo parametro è disponibile solo in Exchange locale.
Il parametro ConditionalCompany consente di specificare un filtro pre-analizzato basato sul valore della proprietà Company del destinatario.
Quando si usano più valori per questo parametro, viene applicato l'operatore booleano OR. Per altre informazioni sul funzionamento dei parametri condizionali, vedere la sezione Descrizione dettagliata di questo argomento.
Per immettere più valori che sovrascrivono le voci esistenti, usare la sintassi seguente: Value1,Value2,...ValueN
. Se i valori contengono spazi o altrimenti richiedono virgolette, usare la sintassi seguente: "Value","Value2",..."ValueN"
.
Per aggiungere o rimuovere uno o più valori senza influire sulle voci esistenti, usare la sintassi seguente: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}
.
Type: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-ConditionalCustomAttribute1
Questo parametro è disponibile solo in Exchange locale.
Il parametro ConditionalCustomAttribute1 specifica un filtro pre-analizzato basato sul valore della proprietà CustomAttribute1 del destinatario. È possibile specificare più valori separati da virgole.
Quando si usano più valori per questo parametro, viene applicato l'operatore booleano OR. Per altre informazioni sul funzionamento dei parametri condizionali, vedere la sezione Descrizione dettagliata di questo argomento.
Per immettere più valori che sovrascrivono le voci esistenti, usare la sintassi seguente: Value1,Value2,...ValueN
. Se i valori contengono spazi o altrimenti richiedono virgolette, usare la sintassi seguente: "Value","Value2",..."ValueN"
.
Per aggiungere o rimuovere uno o più valori senza influire sulle voci esistenti, usare la sintassi seguente: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}
.
Type: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-ConditionalCustomAttribute10
Questo parametro è disponibile solo in Exchange locale.
Il parametro ConditionalCustomAttribute10 specifica un filtro pre-analizzato basato sul valore della proprietà CustomAttribute10 del destinatario. È possibile specificare più valori separati da virgole.
Quando si usano più valori per questo parametro, viene applicato l'operatore booleano OR. Per altre informazioni sul funzionamento dei parametri condizionali, vedere la sezione Descrizione dettagliata di questo argomento.
Per immettere più valori che sovrascrivono le voci esistenti, usare la sintassi seguente: Value1,Value2,...ValueN
. Se i valori contengono spazi o altrimenti richiedono virgolette, usare la sintassi seguente: "Value","Value2",..."ValueN"
.
Per aggiungere o rimuovere uno o più valori senza influire sulle voci esistenti, usare la sintassi seguente: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}
.
Type: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-ConditionalCustomAttribute11
Questo parametro è disponibile solo in Exchange locale.
Il parametro ConditionalCustomAttribute11 specifica un filtro pre-analizzato basato sul valore della proprietà CustomAttribute11 del destinatario. È possibile specificare più valori separati da virgole.
Quando si usano più valori per questo parametro, viene applicato l'operatore booleano OR. Per altre informazioni sul funzionamento dei parametri condizionali, vedere la sezione Descrizione dettagliata di questo argomento.
Per immettere più valori che sovrascrivono le voci esistenti, usare la sintassi seguente: Value1,Value2,...ValueN
. Se i valori contengono spazi o altrimenti richiedono virgolette, usare la sintassi seguente: "Value","Value2",..."ValueN"
.
Per aggiungere o rimuovere uno o più valori senza influire sulle voci esistenti, usare la sintassi seguente: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}
.
Type: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-ConditionalCustomAttribute12
Questo parametro è disponibile solo in Exchange locale.
Il parametro ConditionalCustomAttribute12 specifica un filtro pre-analizzato basato sul valore della proprietà CustomAttribute12 del destinatario. È possibile specificare più valori separati da virgole.
Quando si usano più valori per questo parametro, viene applicato l'operatore booleano OR. Per altre informazioni sul funzionamento dei parametri condizionali, vedere la sezione Descrizione dettagliata di questo argomento.
Per immettere più valori che sovrascrivono le voci esistenti, usare la sintassi seguente: Value1,Value2,...ValueN
. Se i valori contengono spazi o altrimenti richiedono virgolette, usare la sintassi seguente: "Value","Value2",..."ValueN"
.
Per aggiungere o rimuovere uno o più valori senza influire sulle voci esistenti, usare la sintassi seguente: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}
.
Type: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-ConditionalCustomAttribute13
Questo parametro è disponibile solo in Exchange locale.
Il parametro ConditionalCustomAttribute13 specifica un filtro pre-analizzato basato sul valore della proprietà CustomAttribute13 del destinatario. È possibile specificare più valori separati da virgole.
Quando si usano più valori per questo parametro, viene applicato l'operatore booleano OR. Per altre informazioni sul funzionamento dei parametri condizionali, vedere la sezione Descrizione dettagliata di questo argomento.
Per immettere più valori che sovrascrivono le voci esistenti, usare la sintassi seguente: Value1,Value2,...ValueN
. Se i valori contengono spazi o altrimenti richiedono virgolette, usare la sintassi seguente: "Value","Value2",..."ValueN"
.
Per aggiungere o rimuovere uno o più valori senza influire sulle voci esistenti, usare la sintassi seguente: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}
.
Type: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-ConditionalCustomAttribute14
Questo parametro è disponibile solo in Exchange locale.
Il parametro ConditionalCustomAttribute14 specifica un filtro pre-analizzato basato sul valore della proprietà CustomAttribute14 del destinatario. È possibile specificare più valori separati da virgole.
Quando si usano più valori per questo parametro, viene applicato l'operatore booleano OR. Per altre informazioni sul funzionamento dei parametri condizionali, vedere la sezione Descrizione dettagliata di questo argomento.
Per immettere più valori che sovrascrivono le voci esistenti, usare la sintassi seguente: Value1,Value2,...ValueN
. Se i valori contengono spazi o altrimenti richiedono virgolette, usare la sintassi seguente: "Value","Value2",..."ValueN"
.
Per aggiungere o rimuovere uno o più valori senza influire sulle voci esistenti, usare la sintassi seguente: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}
.
Type: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-ConditionalCustomAttribute15
Questo parametro è disponibile solo in Exchange locale.
Il parametro ConditionalCustomAttribute15 specifica un filtro pre-analizzato basato sul valore della proprietà CustomAttribute15 del destinatario. È possibile specificare più valori separati da virgole.
Quando si usano più valori per questo parametro, viene applicato l'operatore booleano OR. Per altre informazioni sul funzionamento dei parametri condizionali, vedere la sezione Descrizione dettagliata di questo argomento.
Per immettere più valori che sovrascrivono le voci esistenti, usare la sintassi seguente: Value1,Value2,...ValueN
. Se i valori contengono spazi o altrimenti richiedono virgolette, usare la sintassi seguente: "Value","Value2",..."ValueN"
.
Per aggiungere o rimuovere uno o più valori senza influire sulle voci esistenti, usare la sintassi seguente: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}
.
Type: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-ConditionalCustomAttribute2
Questo parametro è disponibile solo in Exchange locale.
Il parametro ConditionalCustomAttribute2 specifica un filtro pre-analizzato basato sul valore della proprietà CustomAttribute2 del destinatario. È possibile specificare più valori separati da virgole.
Quando si usano più valori per questo parametro, viene applicato l'operatore booleano OR. Per altre informazioni sul funzionamento dei parametri condizionali, vedere la sezione Descrizione dettagliata di questo argomento.
Per immettere più valori che sovrascrivono le voci esistenti, usare la sintassi seguente: Value1,Value2,...ValueN
. Se i valori contengono spazi o altrimenti richiedono virgolette, usare la sintassi seguente: "Value","Value2",..."ValueN"
.
Per aggiungere o rimuovere uno o più valori senza influire sulle voci esistenti, usare la sintassi seguente: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}
.
Type: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-ConditionalCustomAttribute3
Questo parametro è disponibile solo in Exchange locale.
Il parametro ConditionalCustomAttribute3 specifica un filtro pre-analizzato basato sul valore della proprietà CustomAttribute3 del destinatario. È possibile specificare più valori separati da virgole.
Quando si usano più valori per questo parametro, viene applicato l'operatore booleano OR. Per altre informazioni sul funzionamento dei parametri condizionali, vedere la sezione Descrizione dettagliata di questo argomento.
Per immettere più valori che sovrascrivono le voci esistenti, usare la sintassi seguente: Value1,Value2,...ValueN
. Se i valori contengono spazi o altrimenti richiedono virgolette, usare la sintassi seguente: "Value","Value2",..."ValueN"
.
Per aggiungere o rimuovere uno o più valori senza influire sulle voci esistenti, usare la sintassi seguente: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}
.
Type: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-ConditionalCustomAttribute4
Questo parametro è disponibile solo in Exchange locale.
Il parametro ConditionalCustomAttribute4 specifica un filtro pre-analizzato basato sul valore della proprietà CustomAttribute4 del destinatario. È possibile specificare più valori separati da virgole.
Quando si usano più valori per questo parametro, viene applicato l'operatore booleano OR. Per altre informazioni sul funzionamento dei parametri condizionali, vedere la sezione Descrizione dettagliata di questo argomento.
Per immettere più valori che sovrascrivono le voci esistenti, usare la sintassi seguente: Value1,Value2,...ValueN
. Se i valori contengono spazi o altrimenti richiedono virgolette, usare la sintassi seguente: "Value","Value2",..."ValueN"
.
Per aggiungere o rimuovere uno o più valori senza influire sulle voci esistenti, usare la sintassi seguente: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}
.
Type: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-ConditionalCustomAttribute5
Questo parametro è disponibile solo in Exchange locale.
Il parametro ConditionalCustomAttribute5 specifica un filtro pre-analizzato basato sul valore della proprietà CustomAttribute5 del destinatario. È possibile specificare più valori separati da virgole.
Quando si usano più valori per questo parametro, viene applicato l'operatore booleano OR. Per altre informazioni sul funzionamento dei parametri condizionali, vedere la sezione Descrizione dettagliata di questo argomento.
Per immettere più valori che sovrascrivono le voci esistenti, usare la sintassi seguente: Value1,Value2,...ValueN
. Se i valori contengono spazi o altrimenti richiedono virgolette, usare la sintassi seguente: "Value","Value2",..."ValueN"
.
Per aggiungere o rimuovere uno o più valori senza influire sulle voci esistenti, usare la sintassi seguente: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}
.
Type: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-ConditionalCustomAttribute6
Questo parametro è disponibile solo in Exchange locale.
Il parametro ConditionalCustomAttribute6 specifica un filtro pre-analizzato basato sul valore della proprietà CustomAttribute6 del destinatario. È possibile specificare più valori separati da virgole.
Quando si usano più valori per questo parametro, viene applicato l'operatore booleano OR. Per altre informazioni sul funzionamento dei parametri condizionali, vedere la sezione Descrizione dettagliata di questo argomento.
Per immettere più valori che sovrascrivono le voci esistenti, usare la sintassi seguente: Value1,Value2,...ValueN
. Se i valori contengono spazi o altrimenti richiedono virgolette, usare la sintassi seguente: "Value","Value2",..."ValueN"
.
Per aggiungere o rimuovere uno o più valori senza influire sulle voci esistenti, usare la sintassi seguente: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}
.
Type: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-ConditionalCustomAttribute7
Questo parametro è disponibile solo in Exchange locale.
Il parametro ConditionalCustomAttribute7 specifica un filtro pre-analizzato basato sul valore della proprietà CustomAttribute7 del destinatario. È possibile specificare più valori separati da virgole.
Quando si usano più valori per questo parametro, viene applicato l'operatore booleano OR. Per altre informazioni sul funzionamento dei parametri condizionali, vedere la sezione Descrizione dettagliata di questo argomento.
Per immettere più valori che sovrascrivono le voci esistenti, usare la sintassi seguente: Value1,Value2,...ValueN
. Se i valori contengono spazi o altrimenti richiedono virgolette, usare la sintassi seguente: "Value","Value2",..."ValueN"
.
Per aggiungere o rimuovere uno o più valori senza influire sulle voci esistenti, usare la sintassi seguente: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}
.
Type: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-ConditionalCustomAttribute8
Questo parametro è disponibile solo in Exchange locale.
Il parametro ConditionalCustomAttribute8 specifica un filtro pre-analizzato basato sul valore della proprietà CustomAttribute8 del destinatario. È possibile specificare più valori separati da virgole.
Quando si usano più valori per questo parametro, viene applicato l'operatore booleano OR. Per altre informazioni sul funzionamento dei parametri condizionali, vedere la sezione Descrizione dettagliata di questo argomento.
Per immettere più valori che sovrascrivono le voci esistenti, usare la sintassi seguente: Value1,Value2,...ValueN
. Se i valori contengono spazi o altrimenti richiedono virgolette, usare la sintassi seguente: "Value","Value2",..."ValueN"
.
Per aggiungere o rimuovere uno o più valori senza influire sulle voci esistenti, usare la sintassi seguente: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}
.
Type: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-ConditionalCustomAttribute9
Questo parametro è disponibile solo in Exchange locale.
Il parametro ConditionalCustomAttribute9 specifica un filtro pre-analizzato basato sul valore della proprietà CustomAttribute9 del destinatario. È possibile specificare più valori separati da virgole.
Quando si usano più valori per questo parametro, viene applicato l'operatore booleano OR. Per altre informazioni sul funzionamento dei parametri condizionali, vedere la sezione Descrizione dettagliata di questo argomento.
Per immettere più valori che sovrascrivono le voci esistenti, usare la sintassi seguente: Value1,Value2,...ValueN
. Se i valori contengono spazi o altrimenti richiedono virgolette, usare la sintassi seguente: "Value","Value2",..."ValueN"
.
Per aggiungere o rimuovere uno o più valori senza influire sulle voci esistenti, usare la sintassi seguente: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}
.
Type: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-ConditionalDepartment
Questo parametro è disponibile solo in Exchange locale.
Il parametro ConditionalDepartment specifica un filtro pre-analizzato basato sul valore della proprietà Department del destinatario. È possibile specificare più valori separati da virgole.
Quando si usano più valori per questo parametro, viene applicato l'operatore booleano OR. Per altre informazioni sul funzionamento dei parametri condizionali, vedere la sezione Descrizione dettagliata di questo argomento.
Per immettere più valori che sovrascrivono le voci esistenti, usare la sintassi seguente: Value1,Value2,...ValueN
. Se i valori contengono spazi o altrimenti richiedono virgolette, usare la sintassi seguente: "Value","Value2",..."ValueN"
.
Per aggiungere o rimuovere uno o più valori senza influire sulle voci esistenti, usare la sintassi seguente: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}
.
Type: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-ConditionalStateOrProvince
Questo parametro è disponibile solo in Exchange locale.
Il parametro ConditionalStateOrProvince specifica un filtro pre-analizzato basato sul valore della proprietà StateOrProvince del destinatario. È possibile specificare più valori separati da virgole.
Quando si usano più valori per questo parametro, viene applicato l'operatore booleano OR. Per altre informazioni sul funzionamento dei parametri condizionali, vedere la sezione Descrizione dettagliata di questo argomento.
Per immettere più valori che sovrascrivono le voci esistenti, usare la sintassi seguente: Value1,Value2,...ValueN
. Se i valori contengono spazi o altrimenti richiedono virgolette, usare la sintassi seguente: "Value","Value2",..."ValueN"
.
Per aggiungere o rimuovere uno o più valori senza influire sulle voci esistenti, usare la sintassi seguente: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}
.
Type: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Confirm
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-*, hanno una pausa predefinita che impone 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 hanno una pausa predefinita. 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.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-DisabledEmailAddressTemplates
Questo parametro è disponibile solo in Exchange locale.
Il parametro DisabledEmailAddressTemplates specifica i modelli di indirizzi di posta elettronica proxy inclusi in un criterio di indirizzo di posta elettronica, ma non usati per configurare gli indirizzi di posta elettronica dei destinatari.
La sintassi valida per questo parametro è Type:AddressFormat
:
- Tipo: tipo di indirizzo di posta elettronica valido come descritto nella sezione "Tipi di indirizzo" in Email criteri di indirizzo in Exchange Server. Ad esempio, smtp o X400. Si noti che non è possibile usare SMTP per specificare un indirizzo di posta elettronica SMTP primario disabilitato.
- AddressFormat: per gli indirizzi di posta elettronica SMTP, un dominio o un sottodominio configurato come dominio accettato (inoltro autorevole o interno) e variabili valide e caratteri di testo ASCII come descritto nella sezione "Formati di indirizzi" in Email criteri di indirizzi in Exchange Server. Ad esempio: alias@contoso.com richiede il valore
%m@contoso.com
e firstname.lastname@contoso.com richiede il valore%g.%s@contoso.com
.
È possibile specificare più modelli di indirizzo di posta elettronica disabilitati separati da virgole: "[Type1:]EmailAddress1","[Type2:]EmailAddress2",..."[TypeN:]EmailAddressN"
.
In genere, questa proprietà viene popolata solo in base ai valori dopo una migrazione da una versione precedente di Exchange. Per cancellare questi valori, usare il valore $null per questo parametro.
Type: | ProxyAddressTemplateCollection |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-DomainController
Questo parametro è disponibile solo in Exchange locale.
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.
Type: | Fqdn |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-EnabledEmailAddressTemplates
Per configurare i tipi di file bloccati, usare il parametro FileTypes.
La sintassi valida per questo parametro è Type:AddressFormat
:
- Tipo: tipo di indirizzo di posta elettronica valido, come descritto nella sezione "Tipi di indirizzi" in Email criteri di indirizzo in Exchange Server. Ad esempio, SMTP per l'indirizzo di posta elettronica principale e smtp per gli indirizzi proxy.
- AddressFormat: per gli indirizzi di posta elettronica SMTP, un dominio o un sottodominio configurato come dominio accettato (inoltro autorevole o interno) e variabili valide e caratteri di testo ASCII come descritto nella sezione "Formati di indirizzi" in Email criteri di indirizzi in Exchange Server. Ad esempio: alias@contoso.com richiede il valore
%m@contoso.com
e firstname.lastname@contoso.com richiede il valore%g.%s@contoso.com
.
Questo parametro richiede almeno un modello con il valore Type SMTP (per definire l'indirizzo di posta elettronica SMTP primario). Dopo di che, se non si include un prefisso di tipo per un modello, viene utilizzato il valore smtp (un indirizzo proxy SMTP).
È possibile specificare più modelli di indirizzo di posta elettronica separati da virgole: "SMTP:PrimarySMTPEmailAddress","[Type1:]EmailAddress1","[Type2:]EmailAddress2",..."[TypeN:]EmailAddressN"
.
Non è possibile usare questo parametro con il parametro EnabledPrimarySMTPAddressTemplate.
In Exchange Online PowerShell, se si usa questo parametro con IncludeUnifiedGroupRecipients, non è possibile usare le variabili nel modello di indirizzo di posta elettronica.
Type: | ProxyAddressTemplateCollection |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-EnabledPrimarySMTPAddressTemplate
Il parametro EnabledPrimarySMTPAddressTemplate specifica la regola nei criteri di indirizzo di posta elettronica usati per generare gli indirizzi di posta elettronica SMTP primari per i destinatari. È possibile usare questo parametro anziché EnabledEmailAddressTemplates se il criterio applica solo l'indirizzo di posta elettronica primario e nessun indirizzo proxy aggiuntivo.
La sintassi valida per questo parametro è un dominio o un sottodominio configurato come dominio accettato autorevole e variabili valide e caratteri di testo ASCII come descritto nella sezione "Formato indirizzo" in Email criteri di indirizzo in Exchange Server. Ad esempio: alias@contoso.com richiede il valore %m@contoso.com
e firstname.lastname@contoso.com richiede il valore %g.%s@contoso.com
.
Non è possibile usare questo parametro con il parametro EnabledEmailAddressTemplates.
In Exchange Online PowerShell, se si usa questo parametro con IncludeUnifiedGroupRecipients, non è possibile usare le variabili nel modello di indirizzo di posta elettronica.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-ForceUpgrade
L'opzione ForceUpgrade elimina il messaggio di conferma visualizzato se l'oggetto è stato creato in una versione precedente di Exchange. Con questa opzione non è necessario specificare alcun valore.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-Identity
Il parametro Identity consente di specificare i criteri di indirizzo di posta elettronica che si desidera modificare. È possibile utilizzare qualsiasi valore che identifichi il criterio in modo univoco. Ad esempio:
- Nome
- Nome distinto (DN)
- GUID
Type: | EmailAddressPolicyIdParameter |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-IncludedRecipients
Questo parametro è disponibile solo in Exchange locale.
Il parametro IncludedRecipients specifica un filtro pre-analizzato basato sul tipo di destinatario. I valori validi sono:
- AllRecipients: questo valore può essere usato solo da solo.
- MailboxUsers
- MailContacts
- MailGroups
- MailUsers
- MailUsers
È possibile specificare più valori separati da virgole. Quando si usano più valori, viene applicato l'operatore booleano OR.
Type: | WellKnownRecipientType |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Name
Il parametro Name consente di specificare il nome univoco per i criteri dell'indirizzo di posta elettronica. La lunghezza massima è 64 caratteri. Se il valore contiene degli spazi, è necessario racchiuderlo tra virgolette (").
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-Priority
Il parametro Priority consente di specificare l'ordine in cui vengono valutati i criteri di indirizzo di posta elettronica. Per impostazione predefinita, ogni volta che si aggiunge un nuovo criterio di indirizzo di posta elettronica, ai criteri viene assegnata la priorità N+1, dove N è il numero di criteri di indirizzo di posta elettronica creati.
Il Priority parametro specifica l'ordine valutato dai criteri indirizzo di posta elettronica. Per impostazione predefinita, ogni volta che viene aggiunto un nuovo criterio indirizzo di posta elettronica, a questo viene assegnata una priorità di N+ 1, in cui N è il numero dei criteri indirizzo di posta elettronica creati.
Nota: il primo criterio di indirizzo di posta elettronica che identifica un destinatario configura gli indirizzi di posta elettronica del destinatario. Tutti gli altri criteri vengono ignorati, anche se il primo criterio verrà annullato e non è possibile configurare gli indirizzi di posta elettronica del destinatario.
Type: | EmailAddressPolicyPriority |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-RecipientContainer
Questo parametro è disponibile solo in Exchange locale.
Il parametro RecipientContainer consente di specificare un filtro basato sulla posizione del destinatario in Active Directory. L'input valido per questo parametro è un'unità organizzativa o un dominio restituito dal cmdlet Get-OrganizationalUnit. È possibile utilizzare qualsiasi valore che identifichi l'unità organizzativa o il dominio in modo univoco. Ad esempio:
- Nome
- Nome
- Nome distinto (DN)
- GUID
GUID
Type: | OrganizationalUnitIdParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-RecipientFilter
Questo parametro è disponibile solo in Exchange locale.
Il parametro RecipientFilter consente di specificare un filtro OPATH personalizzato basato sul valore di qualsiasi proprietà del destinatario disponibile. È possibile usare qualsiasi operatore di Windows PowerShell disponibile e sono supportati caratteri jolly e corrispondenze parziali. I criteri di ricerca usano la sintassi "Property -ComparisonOperator 'Value'"
.
- Racchiudere l'intero filtro OPATH tra virgolette doppie " ". Se il filtro contiene valori di sistema (ad esempio,
$true
,$false
o$null
), usare le virgolette singole ''. Sebbene questo parametro sia una stringa (non un blocco di sistema), è anche possibile usare le parentesi graffe { }, ma solo se il filtro non contiene variabili. - La proprietà è una proprietà filtrabile. Per le proprietà filtrabili, vedere Proprietà filtrabili per il parametro RecipientFilter.
- ComparisonOperator è un operatore di confronto OPATH, ad esempio
-eq
per equals e-like
per il confronto di stringhe. Per ulteriori informazioni sugli operatori di confronto, vedere about_Comparison_Operators. - Value è il valore della proprietà su cui filtrare. Racchiudere valori di testo e variabili tra virgolette singole (
'Value'
o'$Variable'
). Se un valore variabile contiene virgolette singole, è necessario identificare (escape) le virgolette singole per espandere correttamente la variabile. Ad esempio, invece di'$User'
, usare'$($User -Replace "'","''")'
. Non racchiudere valori interi o di sistema tra virgolette, ad esempio usare500
,$true
,$false
o$null
. - I caratteri jolly sono validi solo come primo o ultimo carattere. Ad esempio,
'Sales*'
o'*Sales'
sono consentiti, ma'Sa*les'
non sono consentiti.
Per informazioni dettagliate sui filtri OPATH in Exchange, vedere Informazioni aggiuntive sulla sintassi OPATH.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-WhatIf
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.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
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.