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