Get-AddressList

Referencia

Módulo:: ExchangePowerShell

Se aplica a:: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

Este cmdlet está disponible en Exchange local y en el servicio basado en la nube. Puede que algunos parámetros y opciones de configuración sean exclusivos de un entorno u otro.

Use el cmdlet Get-AddressList para ver las listas de direcciones.

En Exchange Online, este cmdlet solo está disponible en el rol Listas de direcciones y, de forma predeterminada, el rol no se asigna a ningún grupo de roles. Para usar este cmdlet, debe agregar el rol Listas de direcciones a un grupo de roles (por ejemplo, al grupo de roles Administración de la organización). Para obtener más información, vea Agregar un rol a un grupo de roles.

Para obtener más información acerca de los conjuntos de parámetros de la sección Sintaxis a continuación, vea Sintaxis del cmdlet de Exchange.

Syntax

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

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

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

Description

Puede canalizar la salida del cmdlet Get-AddressList a los cmdlets Remove-AddressList, Set-AddressList, Update-AddressList y Move-AddressList en lugar de usar el parámetro Identity con cada uno de esos cmdlets.

Deberá tener asignados permisos antes de poder ejecutar este cmdlet. Aunque en este tema se enumeran todos los parámetros correspondientes a este cmdlet, tal vez no tenga acceso a algunos parámetros si no están incluidos en los permisos que se le han asignado. Para obtener los permisos necesarios para ejecutar cualquier cmdlet o parámetro en su organización, consulte Find the permissions required to run any Exchange cmdlet.

Ejemplos

Ejemplo 1

Get-AddressList

En este ejemplo se muestra una lista resumida de todas las listas de direcciones.

Ejemplo 2

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

En este ejemplo se muestra información detallada de la lista de direcciones denominada Edificio4 que se encuentra en la lista de direcciones Todos los usuarios\Ventas\.

Parámetros

-Container

El parámetro Container filtra los resultados según la ubicación de la lista de direcciones. Se devuelven solo las listas de direcciones en la ruta de acceso especificada. La entrada válida para este parámetro es con la raíz "\" (también conocida como todas las listas de direcciones) o en una lista de direcciones existente. Puede usar cualquier valor que identifique la lista de direcciones de forma exclusiva. Por ejemplo:

Nombre
Nombre completo (DN)
GUID
Ruta de acceso: "\AddressListName" o "\ContainerName\AddressListName" (por ejemplo, "\All Users" o "\All Contacts\Marketing")

No puede usar este parámetro con los parámetros 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

Este parámetro solo está disponible en Exchange local.

El parámetro DomainController especifica el controlador de dominio que el cmdlet usa para leer datos de Active Directory o escribirlos. El controlador de dominio se identifica por su nombre de dominio completo (FQDN). Por ejemplo, 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

El parámetro Identity especifica la lista de direcciones que desea ver. Puede usar cualquier valor que identifique de forma exclusiva la lista de direcciones. Por ejemplo:

Nombre
Nombre completo (DN)
GUID
Ruta de acceso: "\AddressListName" o "\ContainerName\AddressListName" (por ejemplo, "\All Users" o "\All Contacts\Marketing")

No puede usar este parámetro con los parámetros 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

El parámetro SearchText filtra los resultados según el nombre y el nombre para mostrar de la lista de direcciones. Solo se muestran las listas de direcciones cuyos nombres o nombres para mostrar contienen la cadena de texto especificada. Si el valor contiene espacios, escriba el valor entre comillas (").

No puede usar este parámetro con los parámetros 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

Entradas

Input types

Para ver los tipos de entrada que acepta este cmdlet, consulte Tipos de entrada y salida de cmdlet. Si el campo Tipo de entrada de un cmdlet está en blanco, el cmdlet no acepta datos de entrada.

Salidas

Output types

Para ver los tipos de valor devuelto (también conocidos como tipos de resultado) que acepta este cmdlet, consulte Tipos de entrada y salida de cmdlet. Si el campo Tipo de resultado está en blanco, el cmdlet no devuelve datos.