Get-AddressList

Riferimento

Modulo:: ExchangePowerShell

Si applica a:: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

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 Get-AddressList per visualizzare gli elenchi di indirizzi.

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

Get-AddressList
   -Container <AddressListIdParameter>
   [-DomainController <Fqdn>]
   [<CommonParameters>]

Get-AddressList
   [[-Identity] <AddressListIdParameter>]
   [-DomainController <Fqdn>]
   [<CommonParameters>]

Get-AddressList
   [-SearchText <String>]
   [-DomainController <Fqdn>]
   [<CommonParameters>]

Descrizione

È possibile inviare tramite pipe l'output dal cmdlet Get-AddressList ai cmdlet Remove-AddressList, Set-AddressList, Update-AddressList e Move-AddressList anziché usare il parametro Identity con ognuno di questi cmdlet.

È 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

Get-AddressList

In questo esempio viene visualizzato un elenco riepilogativo di tutti gli elenchi indirizzi.

Esempio 2

Get-AddressList -Identity "All Users\Sales\building4" | Format-List

Questo esempio consente di visualizzare informazioni dettagliate relative all'elenco indirizzi denominato building4, situato sotto l'elenco indirizzi All Users\Sales\.

Parametri

-Container

Il parametro Container consente di filtrare i risultati in base al percorso dell'elenco indirizzi. Vengono restituiti solo gli elenchi indirizzi presenti nel percorso specificato. I valori validi per questo parametro sono rappresentati dalla radice "\" (anche nota come Tutti gli elenchi indirizzi) o da 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")

Non è possibile utilizzare questa opzione con i parametri Identity o SearchText.

Type:	AddressListIdParameter
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

-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

-Identity

Il parametro Identity consente di specificare l'elenco indirizzi che si desidera visualizzare. È 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")

Non è possibile utilizzare questa opzione con i parametri Container o SearchText.

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

-SearchText

Il parametro SearchText consente di filtrare i risultati in base al nome e al nome visualizzato dell'elenco indirizzi. Vengono restituiti soltanto gli elenchi indirizzi con nomi o nomi visualizzati che includono la stringa di testo specificata. Se il valore contiene degli spazi, è necessario racchiuderlo tra virgolette (").

Non è possibile utilizzare questa opzione con i parametri Container o Identity.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	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.