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:
|
||
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:
In RecipientFilter viene utilizzata la sintassi 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 |
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. |
.gif "note")
Nota: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"