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 degli elenchi di indirizzi e, per impostazione predefinita, il ruolo non viene assegnato ai gruppi di ruoli. Per utilizzare questo cmdlet, è necessario aggiungere il ruolo degli elenchi di indirizzi a un gruppo di ruoli, ad esempio il 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 eseguire il piping dell'output del cmdlet Get-AddressList ai cmdlet Remove-AddressList, Set-AddressList, Update-AddressList e Move-AddressList anziché utilizzare 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

In questo esempio vengono restituite informazioni dettagliate per l'elenco indirizzi denominato building4that's che si trova nell'elenco tutti gli utenti \ Sales \ Address List.

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. L'input valido per questo parametro è la radice " \ " (nota anche come tutti gli elenchi di indirizzi) o un elenco di indirizzi esistente. È possibile utilizzare qualsiasi valore che identifichi l'elenco indirizzi in modo univoco. Ad esempio:

  • Nome
  • Nome distinto (DN)
  • GUID
  • Percorso: "\AddressListName" oppure "\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
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
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" oppure "\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
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 spazi è necessario racchiuderlo tra virgolette (").

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

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

Input

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

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.