Get-ExchangeSettings
Этот командлет доступен только в локальной среде Exchange.
Используйте командлет Get-ExchangeSettings для просмотра настраиваемых объектов параметров Exchange, хранящихся в Active Directory. Командлет New-ExchangeSettings используется для создания объекта параметров, а командлет Set-ExchangeSettings — для определения фактических параметров.
Сведения о наборах параметров в разделе Синтаксис ниже см. В разделе Синтаксис командлета Exchange.
Синтаксис
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
Параметр ConfigName фильтрует результаты по указанному имени свойства. Указанное значение отображается в свойстве EffectiveSetting.
Доступные значения определяются схемой объекта параметра Exchange.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2016, Exchange Server 2019 |
-Database
Параметр Database фильтрует результаты по базе данных почтовых ящиков. Вы можете использовать любое значение, уникальным образом идентифицирующее базу данных. Пример:
- имя;
- различающееся имя (DN);
- ExchangeLegacyDN
- GUID
Type: | DatabaseIdParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2016, Exchange Server 2019 |
-Diagnostic
Параметр Diagnostic указывает, требуется ли указывать в результатах данные с очень высоким уровнем детализации. Для этого переключателя не требуется указывать значение.
Подробные сведения доступны в свойстве DiagnosticInfo.
Обычно этот параметр используется только по запросу службы поддержки пользователей Майкрософт для устранения проблем.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2016, Exchange Server 2019 |
-DiagnosticArgument
Параметр DiagnosticArgument изменяет результаты, возвращаемые с помощью параметра Diagnostic. Обычно параметры Diagnostic и DiagnosticArgument используются только по запросу службы поддержки пользователей Майкрософт для устранения проблем.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2016, Exchange Server 2019 |
-DomainController
Параметр 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 2016, Exchange Server 2019 |
-Force
Переключатель "Принудительно" скрывает сообщения с предупреждениями или подтверждениями. Указывать значение для этого параметра необязательно.
Этот параметр можно применять для программного выполнения задач, не требующего вмешательства администратора.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2016, Exchange Server 2019 |
-GenericScopeName
Параметр GenericScopeName фильтрует результаты по области. Доступные значения определяются схемой объекта параметра Exchange.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2016, Exchange Server 2019 |
-GenericScopes
Параметр GenericScopes фильтрует результаты по области. Доступные значения определяются схемой объекта параметра Exchange. Этот параметр использует синтаксис "key1=value1","key2=value2", "keyN=valueN
.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2016, Exchange Server 2019 |
-GenericScopeValue
Параметр GenericScopeValue фильтрует результаты по значению области, заданному параметром GenericScopeName. Доступные значения определяются схемой объекта параметра Exchange.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2016, Exchange Server 2019 |
-Identity
Параметр Identity указывает имя объекта параметра Exchange. Вы можете использовать любое значение, однозначно определяющее объект. Примеры:
- имя;
- различающееся имя (DN);
- GUID
Type: | ExchangeSettingsIdParameter |
Position: | 1 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2016, Exchange Server 2019 |
-Organization
Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.
Type: | OrganizationIdParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2016, Exchange Server 2019 |
-Process
Параметр Process фильтрует результаты по указанному процессу. Доступные значения определяются схемой объекта параметра Exchange.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2016, Exchange Server 2019 |
-Server
Параметр Server фильтрует результаты по Exchange Server. Можно использовать любое значение, однозначно определяющее сервер. Примеры:
- имя;
- различающееся имя (DN);
- ExchangeLegacyDN
- GUID
Type: | ServerIdParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2016, Exchange Server 2019 |
-User
Параметр User фильтрует результаты по пользователям. Вы идентифицируете пользователя по значению GUID (например, 87246450-1b19-4c81-93dc-1a4200eff66c). Чтобы найти ИДЕНТИФИКАТОР GUID для пользователя, выполните следующую команду: Get-User <UserIdentity> | Format-List Name,GUID
.
Type: | Guid |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2016, Exchange Server 2019 |