New-DynamicDistributionGroup
Questo cmdlet è disponibile in Exchange locale e nel servizio basato su cloud. Alcuni parametri e impostazioni potrebbero essere esclusivi per un ambiente o l'altro.
Utilizzare il cmdlet New-DynamicDistributionGroup per creare gruppi di distribuzione dinamici. Un gruppo di distribuzione dinamico consente di interrogare gli oggetti abilitati alla posta elettronica e di creare l'appartenenza al gruppo in base ai risultati. L'appartenenza al gruppo viene ricalcolata ogni volta che viene inviato al gruppo un messaggio di posta elettronica.
Per informazioni sui set di parametri nella sezione Sintassi, vedere Sintassi del cmdlet di Exchange.
Sintassi
PrecannedFilter
New-DynamicDistributionGroup
[-Name] <String>
-IncludedRecipients <WellKnownRecipientType>
[-Alias <String>]
[-ArbitrationMailbox <MailboxIdParameter>]
[-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]
[-DirectMembershipOnly <Boolean>]
[-DisplayName <String>]
[-DomainController <Fqdn>]
[-ModeratedBy <MultiValuedProperty>]
[-ModerationEnabled <Boolean>]
[-OrganizationalUnit <OrganizationalUnitIdParameter>]
[-PrimarySmtpAddress <SmtpAddress>]
[-RecipientContainer <OrganizationalUnitIdParameter>]
[-SendModerationNotifications <TransportModerationNotificationFlags>]
[-WhatIf]
[<CommonParameters>]
CustomFilter
New-DynamicDistributionGroup
[-Name] <String>
-RecipientFilter <String>
[-Alias <String>]
[-ArbitrationMailbox <MailboxIdParameter>]
[-Confirm]
[-DirectMembershipOnly <Boolean>]
[-DisplayName <String>]
[-DomainController <Fqdn>]
[-ModeratedBy <MultiValuedProperty>]
[-ModerationEnabled <Boolean>]
[-OrganizationalUnit <OrganizationalUnitIdParameter>]
[-PrimarySmtpAddress <SmtpAddress>]
[-RecipientContainer <OrganizationalUnitIdParameter>]
[-SendModerationNotifications <TransportModerationNotificationFlags>]
[-WhatIf]
[<CommonParameters>]
Descrizione
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.
È 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
New-DynamicDistributionGroup -Name "Marketing Group" -IncludedRecipients "MailboxUsers,MailContacts" -ConditionalDepartment "Marketing","Sales"
Questo esempio crea un gruppo di distribuzione dinamico denominato Marketing Group che contiene tutti i destinatari che dispongono di un campo Department equivalente alle stringhe "Marketing" o "Sales". Poiché non vengono utilizzati i parametri OrganizationalUnit o RecipientContainer, il gruppo viene visualizzato per tutti i destinatari nel percorso predefinito (in genere, il contenitore "Users").
Esempio 2
New-DynamicDistributionGroup -Name "Washington Management Team" -RecipientFilter "(RecipientTypeDetails -eq 'UserMailbox') -and (Title -like 'Director*' -or Title -like 'Manager*') -and (StateOrProvince -eq 'WA')" -RecipientContainer "North America"
In questo esempio viene creato un gruppo di distribuzione dinamico denominato Washington Management Team che contiene tutti gli utenti dell'unità organizzativa denominata America del Nord dello stato di Washington i cui titoli iniziano con "Director" o "Manager".
Parametri
-Alias
Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection
Il parametro Alias consente di specificare l'alias di Exchange (noto anche come alias di posta elettronica) per il destinatario. Questo valore consente di identificare il destinatario come oggetto abilitato alla posta elettronica e non deve essere confuso con più indirizzi di posta elettronica dello stesso destinatario (noti anche come indirizzi proxy). Un destinatario può disporre di un solo valore Alias. La lunghezza massima è 64 caratteri.
Il valore Alias può contenere lettere, numeri e i caratteri seguenti:
- !, #, %, *, +, -, /, =, ?, ^, _, e ~.
- $, &, ', ', {, }e | deve essere preceduto da caratteri di escape (ad esempio
-Alias what`'snew) o dall'intero valore racchiuso tra virgolette singole (ad esempio,-Alias 'what'snew'). Il carattere & non è supportato nel valore Alias per la sincronizzazione Microsoft Entra Connect. - I punti (.) devono essere racchiusi tra altri caratteri validi,
help.deskad esempio . - Caratteri Unicode da U+00A1 a U+00FF.
Quando si crea un destinatario senza specificare un indirizzo di posta elettronica, il valore Alias specificato viene usato per generare l'indirizzo di posta elettronica primario (alias@domain). I caratteri Unicode supportati sono mappati per adattarsi ai caratteri di testo US-ASCII in modo ottimale. Ad esempio, U+00F6 (ö) viene modificato oe in nell'indirizzo di posta elettronica primario.
Se non si usa il parametro Alias quando si crea un destinatario, il valore di un parametro obbligatorio diverso viene usato per il valore della proprietà Alias:
- Destinatari con account utente ,ad esempio cassette postali utente e utenti di posta elettronica: viene usato il lato sinistro del parametro MicrosoftOnlineServicesID o UserPrincipalName. Ad esempio, restituisce helpdesk@contoso.onmicrosoft.com il valore
helpdeskdella proprietà Alias . - Destinatari senza account utente (ad esempio, cassette postali della sala, contatti di posta elettronica e gruppi di distribuzione): viene usato il valore del parametro Name. Gli spazi vengono rimossi e i caratteri non supportati vengono convertiti in punti interrogativi (?).
Se si modifica il valore Alias di un destinatario esistente, l'indirizzo di posta elettronica primario viene aggiornato automaticamente solo negli ambienti in cui il destinatario è soggetto a criteri di indirizzo di posta elettronica (la proprietà EmailAddressPolicyEnabled è True per il destinatario).
Il parametro Alias non genera o aggiorna mai l'indirizzo di posta elettronica principale di un contatto di posta elettronica o di un utente di posta elettronica.
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 |
-ArbitrationMailbox
Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
Questo parametro è disponibile solo in Exchange locale.
Il parametro ArbitrationMailbox consente di specificare la cassetta postale di arbitrato utilizzata per la gestione del processo di moderazione per il destinatario. È possibile utilizzare qualsiasi valore che identifichi la cassetta postale di arbitrato in modo univoco. Ad esempio:
- Nome
- Alias
- Nome distinto (DN)
- Nome distinto (DN)
- Dominio\Nome utente
- Indirizzo di posta elettronica
- GUID
- LegacyExchangeDN
- SamAccountName
- ID utente o Nome entità utente (UPN)
Proprietà dei parametri
| Tipo: | MailboxIdParameter |
| 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 |
-ConditionalCompany
Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection
Il parametro ConditionalCompany consente di specificare un filtro pre-analizzato basato sul valore della proprietà Company 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.
Questo parametro viene usato in combinazione con il parametro IncludedRecipients come parte di un filtro pre-analizzato. Non è possibile usare parametri condizionali in combinazione con il parametro RecipientFilter (usato per creare filtri OPATH personalizzati).
Proprietà dei parametri
| Tipo: | MultiValuedProperty |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
PrecannedFilter
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-ConditionalCustomAttribute1
Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection
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.
Questo parametro viene usato in combinazione con il parametro IncludedRecipients come parte di un filtro pre-analizzato. Non è possibile usare parametri condizionali in combinazione con il parametro RecipientFilter (usato per creare filtri OPATH personalizzati).
Proprietà dei parametri
| Tipo: | MultiValuedProperty |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
PrecannedFilter
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-ConditionalCustomAttribute10
Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection
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.
Questo parametro viene usato in combinazione con il parametro IncludedRecipients come parte di un filtro pre-analizzato. Non è possibile usare parametri condizionali in combinazione con il parametro RecipientFilter (usato per creare filtri OPATH personalizzati).
Proprietà dei parametri
| Tipo: | MultiValuedProperty |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
PrecannedFilter
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-ConditionalCustomAttribute11
Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection
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.
Questo parametro viene usato in combinazione con il parametro IncludedRecipients come parte di un filtro pre-analizzato. Non è possibile usare parametri condizionali in combinazione con il parametro RecipientFilter (usato per creare filtri OPATH personalizzati).
Proprietà dei parametri
| Tipo: | MultiValuedProperty |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
PrecannedFilter
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-ConditionalCustomAttribute12
Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection
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.
Questo parametro viene usato in combinazione con il parametro IncludedRecipients come parte di un filtro pre-analizzato. Non è possibile usare parametri condizionali in combinazione con il parametro RecipientFilter (usato per creare filtri OPATH personalizzati).
Proprietà dei parametri
| Tipo: | MultiValuedProperty |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
PrecannedFilter
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-ConditionalCustomAttribute13
Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection
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.
Questo parametro viene usato in combinazione con il parametro IncludedRecipients come parte di un filtro pre-analizzato. Non è possibile usare parametri condizionali in combinazione con il parametro RecipientFilter (usato per creare filtri OPATH personalizzati).
Proprietà dei parametri
| Tipo: | MultiValuedProperty |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
PrecannedFilter
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-ConditionalCustomAttribute14
Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection
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.
Questo parametro viene usato in combinazione con il parametro IncludedRecipients come parte di un filtro pre-analizzato. Non è possibile usare parametri condizionali in combinazione con il parametro RecipientFilter (usato per creare filtri OPATH personalizzati).
Proprietà dei parametri
| Tipo: | MultiValuedProperty |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
PrecannedFilter
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-ConditionalCustomAttribute15
Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection
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.
Questo parametro viene usato in combinazione con il parametro IncludedRecipients come parte di un filtro pre-analizzato. Non è possibile usare parametri condizionali in combinazione con il parametro RecipientFilter (usato per creare filtri OPATH personalizzati).
Proprietà dei parametri
| Tipo: | MultiValuedProperty |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
PrecannedFilter
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-ConditionalCustomAttribute2
Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection
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.
Questo parametro viene usato in combinazione con il parametro IncludedRecipients come parte di un filtro pre-analizzato. Non è possibile usare parametri condizionali in combinazione con il parametro RecipientFilter (usato per creare filtri OPATH personalizzati).
Proprietà dei parametri
| Tipo: | MultiValuedProperty |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
PrecannedFilter
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-ConditionalCustomAttribute3
Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection
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.
Questo parametro viene usato in combinazione con il parametro IncludedRecipients come parte di un filtro pre-analizzato. Non è possibile usare parametri condizionali in combinazione con il parametro RecipientFilter (usato per creare filtri OPATH personalizzati).
Proprietà dei parametri
| Tipo: | MultiValuedProperty |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
PrecannedFilter
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-ConditionalCustomAttribute4
Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection
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.
Questo parametro viene usato in combinazione con il parametro IncludedRecipients come parte di un filtro pre-analizzato. Non è possibile usare parametri condizionali in combinazione con il parametro RecipientFilter (usato per creare filtri OPATH personalizzati).
Proprietà dei parametri
| Tipo: | MultiValuedProperty |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
PrecannedFilter
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-ConditionalCustomAttribute5
Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection
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.
Questo parametro viene usato in combinazione con il parametro IncludedRecipients come parte di un filtro pre-analizzato. Non è possibile usare parametri condizionali in combinazione con il parametro RecipientFilter (usato per creare filtri OPATH personalizzati).
Proprietà dei parametri
| Tipo: | MultiValuedProperty |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
PrecannedFilter
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-ConditionalCustomAttribute6
Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection
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.
Questo parametro viene usato in combinazione con il parametro IncludedRecipients come parte di un filtro pre-analizzato. Non è possibile usare parametri condizionali in combinazione con il parametro RecipientFilter (usato per creare filtri OPATH personalizzati).
Proprietà dei parametri
| Tipo: | MultiValuedProperty |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
PrecannedFilter
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-ConditionalCustomAttribute7
Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection
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.
Questo parametro viene usato in combinazione con il parametro IncludedRecipients come parte di un filtro pre-analizzato. Non è possibile usare parametri condizionali in combinazione con il parametro RecipientFilter (usato per creare filtri OPATH personalizzati).
Proprietà dei parametri
| Tipo: | MultiValuedProperty |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
PrecannedFilter
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-ConditionalCustomAttribute8
Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection
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.
Questo parametro viene usato in combinazione con il parametro IncludedRecipients come parte di un filtro pre-analizzato. Non è possibile usare parametri condizionali in combinazione con il parametro RecipientFilter (usato per creare filtri OPATH personalizzati).
Proprietà dei parametri
| Tipo: | MultiValuedProperty |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
PrecannedFilter
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-ConditionalCustomAttribute9
Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection
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.
Questo parametro viene usato in combinazione con il parametro IncludedRecipients come parte di un filtro pre-analizzato. Non è possibile usare parametri condizionali in combinazione con il parametro RecipientFilter (usato per creare filtri OPATH personalizzati).
Proprietà dei parametri
| Tipo: | MultiValuedProperty |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
PrecannedFilter
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-ConditionalDepartment
Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection
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.
Questo parametro viene usato in combinazione con il parametro IncludedRecipients come parte di un filtro pre-analizzato. Non è possibile usare parametri condizionali in combinazione con il parametro RecipientFilter (usato per creare filtri OPATH personalizzati).
Proprietà dei parametri
| Tipo: | MultiValuedProperty |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
PrecannedFilter
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-ConditionalStateOrProvince
Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection
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.
Questo parametro viene usato in combinazione con il parametro IncludedRecipients come parte di un filtro pre-analizzato. Non è possibile usare parametri condizionali in combinazione con il parametro RecipientFilter (usato per creare filtri OPATH personalizzati).
Proprietà dei parametri
| Tipo: | MultiValuedProperty |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
PrecannedFilter
| 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 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection
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 |
-DirectMembershipOnly
Applicabile: Exchange Online, Exchange Online Protection
Questo parametro è disponibile solamente nel servizio basato su cloud.
Questo parametro è riservato all'uso interno da parte di Microsoft.
Proprietà dei parametri
| Tipo: | Boolean |
| Valore predefinito: | False |
| 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 |
-DisplayName
Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection
Il parametro DisplayName specifica il nome visualizzato del gruppo di distribuzione dinamico. Il nome visualizzato è visibile nell'interfaccia di amministrazione di Exchange e negli elenchi di indirizzi. La lunghezza massima è 256 caratteri. Se il valore contiene degli spazi, è necessario racchiuderlo tra virgolette (").
Se non si utilizza il parametro DisplayName, il valore del parametro Name viene utilizzato per il nome visualizzato.
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 |
-DomainController
Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
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.
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 |
-IncludedRecipients
Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection
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.
È necessario usare questo parametro quando si usano parametri condizionali come parte di un filtro pre-analizzato. Non è possibile usare questo parametro in combinazione con il parametro RecipientFilter (usato per creare filtri OPATH personalizzati).
Proprietà dei parametri
| Tipo: | WellKnownRecipientType |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
PrecannedFilter
| Posizione: | Named |
| Obbligatorio: | True |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-ModeratedBy
Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection
Il parametro ModeratedBy consente di specificare uno o più moderatori per il destinatario. Un moderatore approva i messaggi inviati al destinatario prima del recapito dei messaggi. Un moderatore deve essere una cassetta postale, un utente di posta elettronica o un contatto di posta elettronica nell'organizzazione. È possibile utilizzare qualsiasi valore che identifichi il moderatore in modo univoco. Ad esempio:
- Nome
- Alias
- Nome distinto (DN)
- Nome distinto (DN)
- Nome distinto canonico
- GUID
È possibile immettere più valori separati da virgole. Se i valori contengono spazi o richiedono le virgolette, utilizzare la sintassi seguente: "Value1","Value2",..."ValueN".
Usare questo parametro per specificare almeno un moderatore quando si imposta il parametro ModerationEnabled sul valore $true.
Proprietà dei parametri
| Tipo: | MultiValuedProperty |
| 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 |
-ModerationEnabled
Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection
Il parametro ModerationEnabled specifica se la moderazione è abilitata per questo destinatario. I valori validi sono i seguenti:
- $true: la moderazione è abilitata per questo destinatario. I messaggi inviati a questo destinatario devono essere approvati da un moderatore prima del recapito dei messaggi.
- $false: la moderazione è disabilitata per questo destinatario. I messaggi inviati a questo destinatario vengono recapitati senza l'approvazione di un moderatore. Questo valore è il valore predefinito.
Usare il parametro ModeratedBy per specificare i moderatori.
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 |
-Name
Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection
Il parametro Name specifica il nome univoco del gruppo di distribuzione dinamico. La lunghezza massima è 64 caratteri. Se il valore contiene degli spazi, è necessario racchiuderlo tra virgolette (").
Questo valore viene utilizzato anche per la proprietà DisplayName se non si utilizza il parametro DisplayName.
Proprietà dei parametri
| Tipo: | String |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | 1 |
| Obbligatorio: | True |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-OrganizationalUnit
Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection
Il parametro OrganizationalUnit consente di specificare l'unità organizzativa (OU) in cui viene creato il gruppo di distribuzione dinamico.
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
Se non si usa questo parametro, il valore predefinito è in genere il contenitore Utenti nel dominio del server Exchange a cui si è connessi (noto anche come ambito del destinatario). In Exchange locale è possibile modificare l'ambito del destinatario per la sessione corrente di PowerShell usando il cmdlet Set-AdServerSettings.
Se non si usa il parametro RecipientContainer, la posizione del gruppo di distribuzione dinamico viene utilizzata per la proprietà RecipientContainer (il percorso predefinito o il valore specificato per il parametro OrganizationalUnit).
Nota: anche se questo parametro è disponibile in Exchange Online, esiste una sola unità organizzativa utilizzabile in un'organizzazione Exchange Online, quindi l'uso di questo parametro non ha alcun effetto.
Proprietà dei parametri
| Tipo: | OrganizationalUnitIdParameter |
| 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 |
-PrimarySmtpAddress
Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection
Il parametro PrimarySmtpAddress consente di specificare l'indirizzo di posta elettronica primario di risposta utilizzato per il destinatario.
Proprietà dei parametri
| Tipo: | SmtpAddress |
| 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 |
-RecipientContainer
Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection
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
La proprietà RecipientContainer non può essere vuota. Il gruppo è sempre limitato alla ricerca di destinatari in una posizione specifica (il valore specificato per questo parametro o la posizione in cui è stato creato il gruppo).
Nota: anche se questo parametro è disponibile in Exchange Online, esiste una sola unità organizzativa utilizzabile in un'organizzazione Exchange Online, quindi l'uso di questo parametro non ha alcun effetto.
Proprietà dei parametri
| Tipo: | OrganizationalUnitIdParameter |
| 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 |
-RecipientFilter
Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection
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,$falseo$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
-eqper equals e-likeper 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,$falseo$null. - Negli ambienti basati sul cloud non è possibile usare un carattere jolly come primo carattere. Ad esempio,
'Sales*'è consentito, ma'*Sales'non è consentito. - In Exchange locale 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.
Non è possibile usare questo parametro in combinazione con il parametro IncludedRecipients o con i parametri condizionali usati per creare filtri pre-analizzati.
La lunghezza massima per la proprietà RecipientFilter è di 2048 caratteri, inclusa la sintassi interna.
Proprietà dei parametri
| Tipo: | String |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
CustomFilter
| Posizione: | Named |
| Obbligatorio: | True |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-SendModerationNotifications
Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection
Le connessioni client vengono inviate tramite proxy dai servizi Accesso client ai servizi back-end sui server Cassette postali remoti o locali. I valori validi sono:
- Sempre: notifica a tutti i mittenti quando i loro messaggi non sono approvati. Questo valore è il valore predefinito.
- Always: notificare a tutti i mittenti che i relativi messaggi non sono approvati. Questo è il valore predefinito.
- Internal: notificare ai mittenti dell'organizzazione solo i messaggi non approvati.
Questo parametro è significativo solo quando la moderazione è abilitata (il parametro ModerationEnabled ha il valore $true).
Proprietà dei parametri
| Tipo: | TransportModerationNotificationFlags |
| 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 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection
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.