Get-GlobalAddressList
Этот командлет доступен в локальной среде Exchange и в облачной службе. Некоторые параметры и настройки могут отличаться в зависимости от среды.
Используйте командлет Get-GlobalAddressList для просмотра глобального списка адресов (GAL) или набора общедоступных лицензий.
В Exchange Online этот командлет доступен только в роли "Списки адресов", которая по умолчанию не назначена ни одной группе ролей. Чтобы использовать этот командлет, добавьте роль "Списки адресов" в группу ролей (например, в группу ролей "Управление организацией"). Подробнее см. в разделе Добавление роли в группу ролей.
Сведения о наборах параметров в разделе Синтаксис ниже см. В разделе Синтаксис командлета Exchange.
Синтаксис
Get-GlobalAddressList
[-DefaultOnly]
[-DomainController <Fqdn>]
[<CommonParameters>]
Get-GlobalAddressList
[[-Identity] <GlobalAddressListIdParameter>]
[-DomainController <Fqdn>]
[<CommonParameters>]
Описание
Командлет Get-GlobalAddressList в основном используется для заполнения страниц свойств GAL в Центре администрирования Exchange. Эта команда не предоставляет возможность фильтрации. Если требуется фильтрация, следует использовать предложение WHERE с командой .
Для его запуска необходимо получить соответствующие разрешения. В этой статье перечислены все параметры командлета. Но некоторые из них могут быть вам не доступны, если они не включены в назначенные разрешения. Сведения о необходимых разрешениях для запуска командлетов и использования параметров в организации см. в статье Find the permissions required to run any Exchange cmdlet.
Примеры
Пример 1
Get-GlobalAddressList
В этом примере возвращается сводный список всех общедоступных лицензий.
Пример 2
Get-GlobalAddressList -Identity GAL_AgencyB | Format-List
В этом примере возвращаются подробные сведения о глобальном списке адресов с именем GAL_AgencyB.
Параметры
-DefaultOnly
Параметр DefaultOnly фильтрует результаты, поэтому возвращается только глобальный список адресов по умолчанию. Вам не нужно использовать значение с этим параметром.
Type: | SwitchParameter |
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
Type: | GlobalAddressListIdParameter |
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 |
Входные данные
Input types
Сведения о типах входных данных, которые принимает этот командлет, см. в разделе Типы входных и выходных данных командлетов. Если поле Тип ввода для командлета пустое, командлет не принимает входные данные.
Выходные данные
Output types
Сведения о типах возвращаемых данных, которые также называются типами выходных данных, которые принимает этот командлет, см. в разделе Типы входных и выходных данных командлетов. Если поле Тип вывода пусто, командлет не возвращает данные.