New-DynamicDistributionGroup (RTM)

Articolo
08/10/2014

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: Name indica il nome del gruppo di distribuzione dinamica in Utenti e computer di Active Directory e anche nel campo Nome gruppo in Exchange Management Console. DisplayName indica il nome del gruppo di distribuzione dinamico in Exchange Management Console e nell'elenco indirizzi globale di Exchange.
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: IncludedRecipients ConditionalCompany ConditionalCustomAttribute N (dove N è un valore compreso tra 1 e 15) ConditionalDepartment ConditionalStateOrProvince RecipientFilter utilizza la sintassi `OPath` per eseguire query in Active Directory e filtrare i destinatari. 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"

Condividi tramite