Get-ExchangeSettings
Этот командлет доступен только в локальной среде Exchange.
Используйте командлет Get-ExchangeSettings для просмотра настраиваемых объектов параметров Exchange, хранящихся в Active Directory. Командлет New-ExchangeSettings используется для создания объекта параметров, а командлет Set-ExchangeSettings — для определения фактических параметров.
Сведения о наборах параметров в разделе Синтаксис ниже см. В разделе Синтаксис командлета Exchange.
Синтаксис
Default (По умолчанию)
Get-ExchangeSettings
[[-Identity] <ExchangeSettingsIdParameter>]
[-ConfigName <String>]
[-Database <DatabaseIdParameter>]
[-Diagnostic]
[-DiagnosticArgument <String>]
[-DomainController <Fqdn>]
[-Force]
[-GenericScopeName <String>]
[-GenericScopes <String[]>]
[-GenericScopeValue <String>]
[-Organization <OrganizationIdParameter>]
[-Process <String>]
[-Server <ServerIdParameter>]
[-User <Guid>]
[<CommonParameters>]
Описание
Для его запуска необходимо получить соответствующие разрешения. Хотя в этой статье перечислены все параметры командлета, у вас может не быть доступа к некоторым параметрам, если они не включены в назначенные вам разрешения. Сведения о необходимых разрешениях для запуска командлетов и использования параметров в организации см. в статье Find the permissions required to run any Exchange cmdlet.
Примеры
Пример 1
Get-ExchangeSettings
В этом примере возвращается сводный список всех объектов параметров Exchange.
Пример 2
Get-ExchangeSettings -Identity Audit | Format-List
В этом примере возвращается сводный список всех объектов параметров Exchange.
Параметры
-ConfigName
Применимо: Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Параметр ConfigName фильтрует результаты по указанному имени свойства. Указанное значение отображается в свойстве EffectiveSetting.
Доступные значения определяются схемой объекта настройки Exchange.
Свойства параметров
| Тип: | String |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Database
Применимо: Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Параметр База данных фильтрует результаты по базе данных почтовых ящиков. Вы можете использовать любое значение, уникальным образом идентифицирующее базу данных. Пример:
- имя;
- различающееся имя (DN);
- ExchangeLegacyDN
- GUID
Свойства параметров
| Тип: | DatabaseIdParameter |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Diagnostic
Применимо: Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Параметр Diagnostic указывает, требуется ли указывать в результатах данные с очень высоким уровнем детализации. С этим параметром не нужно указывать значение.
Подробные сведения доступны в свойстве DiagnosticInfo.
Обычно этот параметр используется только по запросу службы поддержки пользователей Майкрософт для устранения проблем.
Свойства параметров
| Тип: | SwitchParameter |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-DiagnosticArgument
Применимо: Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Параметр DiagnosticArgument изменяет результаты, возвращаемые с помощью параметра Diagnostic. Обычно параметры Diagnostic и DiagnosticArgument используются только по запросу службы поддержки пользователей Майкрософт для устранения проблем.
Свойства параметров
| Тип: | String |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-DomainController
Применимо: Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Параметр DomainController указывает контроллер домена, который используется этим командлетом для чтения или записи данных в Active Directory. Вы определяете контроллер домена по его полному доменному имени (FQDN). Например, dc01.contoso.com.
Свойства параметров
| Тип: | Fqdn |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Force
Применимо: Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Переключатель "Принудительно" скрывает сообщения с предупреждениями или подтверждениями. Указывать значение для этого параметра необязательно.
Этот параметр можно применять для программного выполнения задач, не требующего вмешательства администратора.
Свойства параметров
| Тип: | SwitchParameter |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-GenericScopeName
Применимо: Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Параметр GenericScopeName фильтрует результаты по области. Доступные значения определяются схемой объекта настройки Exchange.
Свойства параметров
| Тип: | String |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-GenericScopes
Применимо: Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Параметр GenericScopes фильтрует результаты по области. Доступные значения определяются схемой объекта настройки Exchange. Синтаксис этого параметра: "key1=value1","key2=value2", "keyN=valueN.
Свойства параметров
| Тип: | String[] |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-GenericScopeValue
Применимо: Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Параметр GenericScopeValue фильтрует результаты по значению области, указанному параметром GenericScopeName. Доступные значения определяются схемой объекта настройки Exchange.
Свойства параметров
| Тип: | String |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Identity
Применимо: Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Параметр Identity определяет имя объекта настройки Exchange. Вы можете использовать любое значение, однозначно определяющее объект. Примеры:
- имя;
- различающееся имя (DN);
- GUID
Внимание: значение $null или несуществующее значение параметра Identity возвращает все объекты так, как если бы вы выполнили команду Get- без параметра Identity. Убедитесь, что все списки значений для параметра Identity точны и не содержат несуществующих значений $null.
Свойства параметров
| Тип: | ExchangeSettingsIdParameter |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | 1 |
| Обязательно: | False |
| Значение из конвейера: | True |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
-Organization
Применимо: Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.
Свойства параметров
| Тип: | OrganizationIdParameter |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Process
Применимо: Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Параметр Process фильтрует результаты по указанному процессу. Доступные значения определяются схемой объекта настройки Exchange.
Свойства параметров
| Тип: | String |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Server
Применимо: Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Параметр Server фильтрует результаты по серверу Exchange. Можно использовать любое значение, однозначно определяющее сервер. Примеры:
- имя;
- различающееся имя (DN);
- ExchangeLegacyDN
- GUID
Свойства параметров
| Тип: | ServerIdParameter |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-User
Применимо: Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Параметр User фильтрует результаты по пользователю. Вы идентифицируете пользователя по значению GUID (например, 87246450-1b19-4c81-93dc-1a4200eff66c). Чтобы найти GUID пользователя, выполните следующую команду: Get-User <UserIdentity> | Format-List Name,GUID.
Свойства параметров
| Тип: | Guid |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
CommonParameters
Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в статье about_CommonParameters.