New-DynamicDistributionGroup

 

Si applica a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

Ultima modifica dell'argomento: 2009-05-12

Il cmdlet New-DynamicDistributionGroup consente di creare un nuovo gruppo di distribuzione dinamico.

Sintassi

New-DynamicDistributionGroup -Name <String> -IncludedRecipients <Nullable> [-Alias <String>] [-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 [<SwitchParameter>]] [-DisplayName <String>] [-DomainController <Fqdn>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-RecipientContainer <OrganizationalUnitIdParameter>] [-TemplateInstance <PSObject>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]]

New-DynamicDistributionGroup -Name <String> -RecipientFilter <String> [-Alias <String>] [-Confirm [<SwitchParameter>]] [-DisplayName <String>] [-DomainController <Fqdn>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-RecipientContainer <OrganizationalUnitIdParameter>] [-TemplateInstance <PSObject>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]]

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 IncludedRecipients consente di filtrare i tipi di destinatari utilizzati per la creazione del 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.
Name	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 di 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.
RecipientFilter	Obbligatorio	System.String	Il parametro RecipientFilter consente di filtrare i destinatari abilitati per la posta utilizzati per la creazione del 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 In RecipientFilter viene utilizzata la sintassi OPath per eseguire le query a Active Directory e filtrare i destinatari. Per ulteriori informazioni sulle proprietà che è possibile filtrare, vedere Proprietà che è possibile filtrare 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 consente di filtrare gli utenti della cassetta postale o i contatti abilitati per la posta utilizzati per la creazione del gruppo di distribuzione dinamico. Se più valori del parametro ConditionalCompany sono separati da virgole, verrà applicato l'operatore booleano OR.
ConditionalCustomAttribute1	Facoltativo	Microsoft.Exchange.Data.MultiValuedProperty	Il parametro ConditionalCustomAttribute1 specifica gli attributi personalizzati. È possibile utilizzare questi attributi per memorizzare informazioni aggiuntive.
ConditionalCustomAttribute10	Facoltativo	Microsoft.Exchange.Data.MultiValuedProperty	Il parametro ConditionalCustomAttribute10 specifica gli attributi personalizzati. È possibile utilizzare questi attributi per memorizzare informazioni aggiuntive.
ConditionalCustomAttribute11	Facoltativo	Microsoft.Exchange.Data.MultiValuedProperty	Il parametro ConditionalCustomAttribute11 specifica gli attributi personalizzati. È possibile utilizzare questi attributi per memorizzare informazioni aggiuntive.
ConditionalCustomAttribute12	Facoltativo	Microsoft.Exchange.Data.MultiValuedProperty	Il parametro ConditionalCustomAttribute12 specifica gli attributi personalizzati. È possibile utilizzare questi attributi per memorizzare informazioni aggiuntive.
ConditionalCustomAttribute13	Facoltativo	Microsoft.Exchange.Data.MultiValuedProperty	Il parametro ConditionalCustomAttribute13 specifica gli attributi personalizzati. È possibile utilizzare questi attributi per memorizzare informazioni aggiuntive.
ConditionalCustomAttribute14	Facoltativo	Microsoft.Exchange.Data.MultiValuedProperty	Il parametro ConditionalCustomAttribute14 specifica gli attributi personalizzati. È possibile utilizzare questi attributi per memorizzare informazioni aggiuntive.
ConditionalCustomAttribute15	Facoltativo	Microsoft.Exchange.Data.MultiValuedProperty	Il parametro ConditionalCustomAttribute15 specifica gli attributi personalizzati. È possibile utilizzare questi attributi per memorizzare informazioni aggiuntive.
ConditionalCustomAttribute2	Facoltativo	Microsoft.Exchange.Data.MultiValuedProperty	Il parametro ConditionalCustomAttribute2 specifica gli attributi personalizzati. È possibile utilizzare questi attributi per memorizzare informazioni aggiuntive.
ConditionalCustomAttribute3	Facoltativo	Microsoft.Exchange.Data.MultiValuedProperty	Il parametro ConditionalCustomAttribute3 specifica gli attributi personalizzati. È possibile utilizzare questi attributi per memorizzare informazioni aggiuntive.
ConditionalCustomAttribute4	Facoltativo	Microsoft.Exchange.Data.MultiValuedProperty	Il parametro ConditionalCustomAttribute4 specifica gli attributi personalizzati. È possibile utilizzare questi attributi per memorizzare informazioni aggiuntive.
ConditionalCustomAttribute5	Facoltativo	Microsoft.Exchange.Data.MultiValuedProperty	Il parametro ConditionalCustomAttribute5 specifica gli attributi personalizzati. È possibile utilizzare questi attributi per memorizzare informazioni aggiuntive.
ConditionalCustomAttribute6	Facoltativo	Microsoft.Exchange.Data.MultiValuedProperty	Il parametro ConditionalCustomAttribute6 specifica gli attributi personalizzati. È possibile utilizzare questi attributi per memorizzare informazioni aggiuntive.
ConditionalCustomAttribute7	Facoltativo	Microsoft.Exchange.Data.MultiValuedProperty	Il parametro ConditionalCustomAttribute7 specifica gli attributi personalizzati. È possibile utilizzare questi attributi per memorizzare informazioni aggiuntive.
ConditionalCustomAttribute8	Facoltativo	Microsoft.Exchange.Data.MultiValuedProperty	Il parametro ConditionalCustomAttribute8 specifica gli attributi personalizzati. È possibile utilizzare questi attributi per memorizzare informazioni aggiuntive.
ConditionalCustomAttribute9	Facoltativo	Microsoft.Exchange.Data.MultiValuedProperty	Il parametro ConditionalCustomAttribute9 specifica gli attributi personalizzati. È possibile utilizzare questi attributi per memorizzare informazioni aggiuntive.
ConditionalDepartment	Facoltativo	Microsoft.Exchange.Data.MultiValuedProperty	Il parametro ConditionalDepartment 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 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.
Confirm	Facoltativo	System.Management.Automation.SwitchParameter	Il parametro Confirm determina l'interruzione dell'elaborazione e richiede che l'utente, prima che l'elaborazione continui, confermi l'operazione che verrà eseguita dal comando. Non è necessario specificare alcun valore con il parametro Confirm.
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.
OrganizationalUnit	Facoltativo	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.
RecipientContainer	Facoltativo	Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter	Il parametro RecipientContainer consente di filtrare i destinatari utilizzati per creare il gruppo di distribuzione dinamico in base alla relativa 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.
UseRusServer	Facoltativo	System.String	Nota: Questo parametro è disponibile solo in Exchange Server 2007 SP2. Il parametro UseRusServer consente al comando di utilizzare il server Cassette postali specificato su cui è in esecuzione il Servizio elenco di indirizzi per ottenere e impostare la cassetta postale e gli attributi dell'utente di Active Directory. Il Servizio elenco indirizzi è un componente del servizio Supervisore sistema di Exchange. Il Servizio elenco indirizzi consente di creare e gestire i valori degli attributi specifici di Exchange in Active Directory. È possibile utilizzare il Servizio elenco indirizzi per aggiornare gli oggetti destinatario in un dominio utilizzando informazioni specifiche, come l'appartenenza a un elenco di indirizzi e gli indirizzi di posta elettronica.
WhatIf	Facoltativo	System.Management.Automation.SwitchParameter	Il parametro WhatIf consente al comando di simulare le azioni da intraprendere sull'oggetto. Utilizzando il parametro WhatIf, è possibile visualizzare quali sono le modifiche che verrebbero apportate senza applicarle. Per il parametro WhatIf non è necessario specificare un valore.

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 Department 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 State/Province 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"