Get-AddressList

Ссылка

Модуль:: ExchangePowerShell

Применяется к:: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

Этот командлет доступен в локальной среде Exchange и в облачной службе. Некоторые параметры и настройки могут отличаться в зависимости от среды.

Используйте командлет Get-AddressList для просмотра списков адресов.

В Exchange Online этот командлет доступен только в роли "Списки адресов", которая по умолчанию не назначена ни одной группе ролей. Чтобы использовать этот командлет, добавьте роль "Списки адресов" в группу ролей (например, в группу ролей "Управление организацией"). Подробнее см. в разделе Добавление роли в группу ролей.

Сведения о наборах параметров в разделе Синтаксис ниже см. В разделе Синтаксис командлета Exchange.

Синтаксис

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

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

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

Описание

Выходные данные командлета Get-AddressList можно передать в командлеты Remove-AddressList, Set-AddressList, Update-AddressList и Move-AddressList вместо использования параметра Identity с каждым из этих командлетов.

Для его запуска необходимо получить соответствующие разрешения. В этой статье перечислены все параметры командлета. Но некоторые из них могут быть вам не доступны, если они не включены в назначенные разрешения. Сведения о необходимых разрешениях для запуска командлетов и использования параметров в организации см. в статье Find the permissions required to run any Exchange cmdlet.

Примеры

Пример 1

Get-AddressList

В этом примере возвращается сводка всех списков адресов.

Пример 2

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

Этот пример возвращает подробные сведения о списке адресов building4, который находится в списке адресов "All Users\Sales\".

Параметры

-Container

Параметр Container фильтрует результаты на основе расположения списка адресов. Возвращаются только списки адресов по указанному пути. Допустимое значение для этого параметра — корневой каталог "\" ("Все списки адресов") или существующий список адресов. Можно использовать любое уникальное значение, определяющее список адресов. Например:

имя;
различающееся имя (DN);
GUID
Путь: "\AddressListName" или "\ContainerName\AddressListName" (например, "\All Users" или "\All Contacts\Marketing")

Этот параметр нельзя использовать вместе с параметром Identity или 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

Этот параметр доступен только в локальной среде Exchange.

Параметр DomainController указывает контроллер домена, который используется этим командлетом для чтения или записи данных в Active Directory. Вы определяете контроллер домена по его полному доменному имени (FQDN). Например, 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

Параметр Identity задает список адресов, который требуется просмотреть. Можно использовать любое уникальное значение, определяющее список адресов. Например:

имя;
различающееся имя (DN);
GUID
Путь: "\AddressListName" или "\ContainerName\AddressListName" (например, "\All Users" или "\All Contacts\Marketing")

Этот параметр нельзя использовать вместе с параметром Container или 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

Параметр SearchText фильтрует результаты на основе имени и отображаемого имени списка адресов. Возвращаются только списки адресов, имена или отображаемые имена которых содержат указанную строку. Если значение содержит пробелы, его необходимо заключить в кавычки (").

Этот параметр нельзя использовать вместе с параметром Container или 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 types

Сведения о типах входных данных, которые принимает этот командлет, см. в разделе Типы входных и выходных данных командлетов. Если поле Тип ввода для командлета пустое, командлет не принимает входные данные.

Выходные данные

Output types

Сведения о типах возвращаемых данных, которые также называются типами выходных данных, которые принимает этот командлет, см. в разделе Типы входных и выходных данных командлетов. Если поле Тип вывода пусто, командлет не возвращает данные.