New-AddressList

Questo cmdlet è disponibile in Exchange locale e nel servizio basato su cloud. Alcuni parametri e impostazioni possono essere esclusivi di singoli ambienti.

Utilizzare il cmdlet New-AddressList per creare elenchi indirizzi e applicarli ai destinatari.

In Exchange Online questo cmdlet è disponibile solo nel ruolo Elenchi indirizzi e per impostazione predefinita il ruolo non è assegnato ad alcun gruppo di ruoli. Per usare questo cmdlet, è necessario aggiungere il ruolo Elenchi indirizzi a un gruppo di ruoli, ad esempio al gruppo di ruoli Gestione organizzazione. Per ulteriori informazioni, vedere Aggiungere un ruolo a un gruppo di ruoli.

Per informazioni sui set di parametri nella sezione Sintassi, vedere Sintassi del cmdlet di Exchange.

Sintassi

New-AddressList
   [-Name] <String>
   -IncludedRecipients <WellKnownRecipientType>
   [-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]
   [-Container <AddressListIdParameter>]
   [-DisplayName <String>]
   [-DomainController <Fqdn>]
   [-RecipientContainer <OrganizationalUnitIdParameter>]
   [-WhatIf]
   [<CommonParameters>]
New-AddressList
   [-Name] <String>
   -RecipientFilter <String>
   [-Confirm]
   [-Container <AddressListIdParameter>]
   [-DisplayName <String>]
   [-DomainController <Fqdn>]
   [-RecipientContainer <OrganizationalUnitIdParameter>]
   [-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.

È necessario disporre delle autorizzazioni prima di poter eseguire questo cmdlet. Sebbene in questo argomento vengano elencati tutti i parametri relativi al cmdlet, si potrebbe non avere accesso ad alcuni di essi qualora non siano inclusi nelle autorizzazioni assegnate. 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-AddressList -Name MyAddressList -RecipientFilter "((RecipientTypeDetails -eq 'UserMailbox') -and ((StateOrProvince -eq 'Washington') -or (StateOrProvince -eq 'Oregon')))"

Con questo esempio viene creato l'elenco indirizzi MyAddressList. L'elenco indirizzi include i destinatari che sono utenti di cassette postali e il cui parametro StateOrProvince è impostato su Washington o Oregon.

Esempio 2

New-AddressList -Name MyAddressList2 -ConditionalStateOrProvince Washington -IncludedRecipients MailboxUsers

Con questo esempio viene creato l'elenco indirizzi MyAddressList2, contenente le cassette postali il cui parametro ConditionalStateOrProvince è impostato su Washington.

Esempio 3

New-AddressList -Name "AL_AgencyB" -RecipientFilter "((RecipientTypeDetails -eq 'UserMailbox') -and (CustomAttribute15 -like 'AgencyB*'))"

Con questo esempio viene creato l'elenco indirizzi AL_AgencyB che include le cassette postali per le quali il valore del parametro CustomAttribute15 contiene AgencyB.

Parametri

-ConditionalCompany

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).

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-ConditionalCustomAttribute1

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).

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-ConditionalCustomAttribute10

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).

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-ConditionalCustomAttribute11

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).

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-ConditionalCustomAttribute12

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).

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-ConditionalCustomAttribute13

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).

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-ConditionalCustomAttribute14

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).

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-ConditionalCustomAttribute15

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).

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-ConditionalCustomAttribute2

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).

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-ConditionalCustomAttribute3

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).

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-ConditionalCustomAttribute4

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).

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-ConditionalCustomAttribute5

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).

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-ConditionalCustomAttribute6

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).

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-ConditionalCustomAttribute7

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).

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-ConditionalCustomAttribute8

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).

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-ConditionalCustomAttribute9

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).

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-ConditionalDepartment

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).

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-ConditionalStateOrProvince

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).

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-Confirm

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-*, hanno una pausa predefinita che impone 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 hanno una pausa predefinita. 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.
Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-Container

Il parametro Container consente di specificare la posizione in cui creare l'elenco indirizzi. I valori validi per questo parametro sono nella radice "\" (anche nota come Tutti gli elenchi indirizzi) o in un elenco indirizzi esistente. È possibile utilizzare qualsiasi valore che identifichi l'elenco indirizzi in modo univoco. Ad esempio:

  • Nome
  • Nome distinto (DN)
  • GUID
  • Percorso: "\AddressListName" o "\ContainerName\AddressListName" (ad esempio, "\All Users" o "\All Contacts\Marketing")

Se non si usa questo parametro, l'elenco indirizzi viene creato nella directory radice (\).

Type:AddressListIdParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-DisplayName

Il parametro DisplayName consente di specificare il nome visualizzato dell'elenco indirizzi. Il nome visualizzato è visibile nell'interfaccia di amministrazione di Exchange e in Outlook. 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.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-DomainController

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.

Type:Fqdn
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-IncludedRecipients

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).

Type:WellKnownRecipientType
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-Name

Il parametro Name consente di specificare il nome univoco per il nuovo elenco indirizzi. La lunghezza massima è di 64 caratteri e non può includere un ritorno a capo o una barra rovesciata (\). Se il valore contiene degli spazi, è necessario racchiuderlo tra virgolette (").

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-RecipientContainer

Questo parametro è disponibile solo in Exchange locale.

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

Type:OrganizationalUnitIdParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-RecipientFilter

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 -eq per equals e -like per 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 usare 500, $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.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-WhatIf

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.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

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.