New-DynamicDistributionGroup (RTM)
Si applica a: Exchange Server 2007
Ultima modifica dell'argomento: 2007-10-23
Il cmdlet New-DynamicDistributionGroup consente di creare un nuovo gruppo di distribuzione dinamico.
Sintassi
New-DynamicDistributionGroup -Name <String> -IncludedRecipients <Nullable> -OrganizationalUnit <OrganizationalUnitIdParameter> [-Alias <String>] [-ConditionalCompany <MultiValuedProperty>] [-ConditionalCustomAttribute1 <String>] [-ConditionalCustomAttribute10 <String>] [-ConditionalCustomAttribute11 <String>] [-ConditionalCustomAttribute12 <String>] [-ConditionalCustomAttribute13 <String>] [-ConditionalCustomAttribute14 <String>] [-ConditionalCustomAttribute15 <String>] [-ConditionalCustomAttribute2 <String>] [-ConditionalCustomAttribute3 <String>] [-ConditionalCustomAttribute4 <String>] [-ConditionalCustomAttribute5 <String>] [-ConditionalCustomAttribute6 <String>] [-ConditionalCustomAttribute7 <String>] [-ConditionalCustomAttribute8 <String>] [-ConditionalCustomAttribute9 <String>] [-ConditionalDepartment <MultiValuedProperty>] [-ConditionalStateOrProvince <MultiValuedProperty>] [-DisplayName <String>] [-DomainController <Fqdn>] [-RecipientContainer <OrganizationalUnitIdParameter>] [-TemplateInstance <PSObject>]
New-DynamicDistributionGroup -Name <String> -OrganizationalUnit <OrganizationalUnitIdParameter> -RecipientFilter <String> [-Alias <String>] [-DisplayName <String>] [-DomainController <Fqdn>] [-RecipientContainer <OrganizationalUnitIdParameter>] [-TemplateInstance <PSObject>]
Descrizione dettagliata
Un gruppo di distribuzione dinamico esegue delle query a oggetti abilitati per la posta del servizio directory di Active Directory e crea l'appartenenza al gruppo in base ai risultati. L'appartenenza al gruppo viene rivalutata ogni volta che un messaggio di posta elettronica viene inviato al gruppo. I filtri di query forniti con Exchange sono limitati a qualsiasi combinazione dei seguenti parametri:
ConditionalCompany
ConditionalCustomAttribute N (dove N è un valore compreso tra 1 e 15)
ConditionalDepartment
ConditionalStateOrProvince
IncludedRecipients
È inoltre possibile creare query personalizzate utilizzando il parametro RecipientFilter.
Per eseguire il cmdlet New-DynamicDistributionGroup, è necessario utilizzare un account che disponga della seguente delega:
- Ruolo Exchange Recipient Administrator
Per ulteriori informazioni sulle autorizzazioni, sulla delega dei ruoli e sui diritti necessari per l'amministrazione di Microsoft Exchange Server 2007, vedere Considerazioni sulle autorizzazioni.
Parametri
| Parametro | Obbligatorio | Tipo | Descrizione |
|---|---|---|---|
IncludedRecipients |
Obbligatorio |
System.Nullable |
Il parametro IncludedRecipient filtra i tipi di destinatari utilizzati per creare il gruppo di distribuzione dinamico. Il parametro IncludedRecipients non può essere utilizzato se è specificato il parametro RecipientFilter. I valori disponibili per il parametro IncludedRecipients sono AllRecipients, MailboxUsers, Resources, MailContacts, MailGroups, Mail Users e None. AllRecipients può essere utilizzato solo singolarmente. Quando più valori di IncludedRecipients sono separati da virgole, viene applicato l'operatore booleano OR. |
Nome |
Obbligatorio |
System.String |
Il parametro Name specifica il nome del gruppo di distribuzione dinamico. Se il parametro DisplayName non è specificato, il valore di Name viene utilizzato per DisplayName. Il valore Name non può contenere più di 64 caratteri. Se i valori dei parametri Name e DisplayName sono diversi:
|
OrganizationalUnit |
Obbligatorio |
Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter |
Il parametro OrganizationalUnit specifica dove creare il gruppo di distribuzione dinamico in Active Directory utilizzando la sintassi del nome canonico. |
RecipientFilter |
Obbligatorio |
System.String |
Il parametro RecipientFilter filtra i destinatari abilitati alla posta utilizzati per creare il gruppo di distribuzione dinamico. RecipientFilter non può essere utilizzato se è specificato uno dei seguenti parametri:
RecipientFilter utilizza la sintassi Per ulteriori informazioni sulle proprietà filtrabili, vedere Proprietà filtrabili per il parametro -RecipientFilter. |
Alias |
Facoltativo |
System.String |
Il parametro Alias consente di specificare l'alias del gruppo di distribuzione dinamico. Il valore del parametro Alias viene utilizzato per generare l'indirizzo di posta elettronica principale SMTP (Simple Mail Transfer Protocol) per il gruppo di distribuzione dinamico. Il valore Alias non può contenere spazi. Se il parametro Alias non è specificato, il valore del parametro Name viene utilizzato come valore del parametro Alias e tutti gli spazi contenuti nel parametro Name vengono convertiti in caratteri di sottolineatura (_). |
ConditionalCompany |
Facoltativo |
Microsoft.Exchange.Data.MultiValuedProperty |
Il parametro ConditionalCompany filtra gli utenti della cassetta postale o i contatti abilitati alla posta utilizzati per creare il gruppo di distribuzione dinamico. Se più valori del parametro ConditionalCompany vengono separati da virgole, verrà applicato l'operatore booleano OR. |
ConditionalCustomAttribute1 |
Facoltativo |
System.String |
Il parametro ConditionalCustomAttribute1 consente di specificare gli attributi personalizzati. È possibile utilizzare questi attributi per memorizzare informazioni aggiuntive. |
ConditionalCustomAttribute10 |
Facoltativo |
System.String |
Il parametro ConditionalCustomAttribute10 consente di specificare gli attributi personalizzati. È possibile utilizzare questi attributi per memorizzare informazioni aggiuntive. |
ConditionalCustomAttribute11 |
Facoltativo |
System.String |
Il parametro ConditionalCustomAttribute11 consente di specificare gli attributi personalizzati. È possibile utilizzare questi attributi per memorizzare informazioni aggiuntive. |
ConditionalCustomAttribute12 |
Facoltativo |
System.String |
Il parametro ConditionalCustomAttribute12 consente di specificare gli attributi personalizzati. È possibile utilizzare questi attributi per memorizzare informazioni aggiuntive. |
ConditionalCustomAttribute13 |
Facoltativo |
System.String |
Il parametro ConditionalCustomAttribute13 consente di specificare gli attributi personalizzati. È possibile utilizzare questi attributi per memorizzare informazioni aggiuntive. |
ConditionalCustomAttribute14 |
Facoltativo |
System.String |
Il parametro ConditionalCustomAttribute14 consente di specificare gli attributi personalizzati. È possibile utilizzare questi attributi per memorizzare informazioni aggiuntive. |
ConditionalCustomAttribute15 |
Facoltativo |
System.String |
Il parametro ConditionalCustomAttribute15 consente di specificare gli attributi personalizzati. È possibile utilizzare questi attributi per memorizzare informazioni aggiuntive. |
ConditionalCustomAttribute2 |
Facoltativo |
System.String |
Il parametro ConditionalCustomAttribute2 consente di specificare gli attributi personalizzati. È possibile utilizzare questi attributi per memorizzare informazioni aggiuntive. |
ConditionalCustomAttribute3 |
Facoltativo |
System.String |
Il parametro ConditionalCustomAttribute3 consente di specificare gli attributi personalizzati. È possibile utilizzare questi attributi per memorizzare informazioni aggiuntive. |
ConditionalCustomAttribute4 |
Facoltativo |
System.String |
Il parametro ConditionalCustomAttribute4 consente di specificare gli attributi personalizzati. È possibile utilizzare questi attributi per memorizzare informazioni aggiuntive. |
ConditionalCustomAttribute5 |
Facoltativo |
System.String |
Il parametro ConditionalCustomAttribute5 consente di specificare gli attributi personalizzati. È possibile utilizzare questi attributi per memorizzare informazioni aggiuntive. |
ConditionalCustomAttribute6 |
Facoltativo |
System.String |
Il parametro ConditionalCustomAttribute6 consente di specificare gli attributi personalizzati. È possibile utilizzare questi attributi per memorizzare informazioni aggiuntive. |
ConditionalCustomAttribute7 |
Facoltativo |
System.String |
Il parametro ConditionalCustomAttribute7 consente di specificare gli attributi personalizzati. È possibile utilizzare questi attributi per memorizzare informazioni aggiuntive. |
ConditionalCustomAttribute8 |
Facoltativo |
System.String |
Il parametro ConditionalCustomAttribute8 consente di specificare gli attributi personalizzati. È possibile utilizzare questi attributi per memorizzare informazioni aggiuntive. |
ConditionalCustomAttribute9 |
Facoltativo |
System.String |
Il parametro ConditionalCustomAttribute9 consente di specificare gli attributi personalizzati. È possibile utilizzare questi attributi per memorizzare informazioni aggiuntive. |
ConditionalDepartment |
Facoltativo |
Microsoft.Exchange.Data.MultiValuedProperty |
Il parametro ConditionalDepartment filtra gli utenti della cassetta postale o i contatti abilitati alla posta utilizzati per creare il gruppo di distribuzione dinamico. Non è possibile utilizzare il parametro ConditionalDepartment se è stato specificato il parametro RecipientFilter. Quando più valori di ConditionalDepartment sono separati da virgole, viene applicato l'operatore booleano OR. |
ConditionalStateOrProvince |
Facoltativo |
Microsoft.Exchange.Data.MultiValuedProperty |
Il parametro ConditionalStateOrProvince consente di filtrare gli utenti della cassetta postale o i contatti abilitati per la posta utilizzati per la creazione del gruppo di distribuzione dinamico. Non è possibile utilizzare il parametro ConditionalStateOrProvince se è stato specificato il parametro RecipientFilter. Quando più valori di ConditionalStateOrProvince sono separati da virgole, viene applicato l'operatore booleano OR. |
DisplayName |
Facoltativo |
System.String |
Il parametro DisplayName consente di specificare il nome del gruppo di distribuzione dinamico in Exchange Management Console e nell'elenco indirizzi globale (GAL, global address list) di Exchange. Se il parametro DisplayName non è specificato, il valore del parametro Name viene utilizzato per il parametro DisplayName. |
DomainController |
Facoltativo |
Microsoft.Exchange.Data.Fqdn |
Per specificare il nome di dominio completo (FQDN) del controller di dominio che scrive la modifica alla configurazione in Active Directory, includere il parametro DomainController. |
RecipientContainer |
Facoltativo |
Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter |
Il parametro RecipientContainer filtra i destinatari utilizzati per creare il gruppo di distribuzione dinamico in base alla loro posizione in Active Directory. Il valore di RecipientContainer può essere il nome canonico di un'unità organizzativa o di un dominio. Se non si specifica un valore per RecipientContainer, il filtro di ricerca predefinito è la posizione del gruppo di distribuzione dinamico in Active Directory. Tale posizione viene specificata utilizzando il parametro OrganizationalUnit. |
TemplateInstance |
Facoltativo |
System.Management.Automation.PSObject |
Quando per il parametro TemplateInstance viene specificato un oggetto esistente, il comando utilizza la configurazione di quell'oggetto per crearne una copia. |
Tipi di input
Tipi restituiti
Errori
| Errore | Descrizione |
|---|---|
|
|
Eccezioni
| Eccezioni | Descrizione |
|---|---|
|
|
Esempio
Gli esempi di codice che seguono mostrano come utilizzare il comando New-DynamicDistributionGroup.
Nel primo esempio viene creato un nuovo gruppo di distribuzione dinamico denominato Marketing Group nel contenitore Users nel dominio Contoso.com. Il gruppo di distribuzione dinamico Marketing Group contiene tutti gli utenti di cassetta postale oppure i contatti abilitati per la posta trovati nel dominio Contoso.com e per i quali il campo Reparto contiene il valore "Marketing" o "Sales".
Nel secondo esempio viene utilizzato il parametro RecipientFilter per creare un gruppo di distribuzione dinamico denominato Pacific Northwest nel contenitore Users nel dominio Contoso.com. Il gruppo di distribuzione dinamico Pacific Northwest contiene tutti gli utenti di cassetta postale trovati nel dominio Contoso.com e per i quali il campo Provincia contiene il valore "Washington" o "Oregon".
New-DynamicDistributionGroup -Name "Marketing Group" -Alias "Marketing_Group" -IncludedRecipients "MailboxUsers,MailContacts" -OrganizationalUnit "Contoso.com/Users" -ConditionalDepartment "Marketing","Sales" -RecipientContainer "Contoso.com"
New-DynamicDistributionGroup -Name "Pacific Northwest" -Alias "Pacific_Northwest" -OrganizationalUnit "Contoso.com/Users" -RecipientFilter {((RecipientType -eq 'UserMailbox') -and ((StateOrProvince -eq 'Washington' -or StateOrProvince -eq 'Oregon')))} -RecipientContainer "Contoso.com"