Set-AuthConfig
Этот командлет доступен только в локальной среде Exchange.
Используйте командлет Set-AuthConfig для изменения конфигурации авторизации для организации Exchange.
Сведения о наборах параметров в разделе Синтаксис ниже см. В разделе Синтаксис командлета Exchange.
Синтаксис
CurrentCertificateParameter
Set-AuthConfig
-CertificateThumbprint <String>
[-SkipImmediateCertificateDeployment]
[-Confirm]
[-DomainController <Fqdn>]
[-Force]
[-Server <ServerIdParameter>]
[-WhatIf]
[<CommonParameters>]
PublishAuthCertificateParameter
Set-AuthConfig
[-ClearPreviousCertificate]
[-PublishCertificate]
[-Confirm]
[-DomainController <Fqdn>]
[-Force]
[-WhatIf]
[<CommonParameters>]
NewCertificateParameter
Set-AuthConfig
[-NewCertificateEffectiveDate <DateTime>]
[-NewCertificateThumbprint <String>]
[-SkipImmediateCertificateDeployment]
[-Confirm]
[-DomainController <Fqdn>]
[-Force]
[-Server <ServerIdParameter>]
[-WhatIf]
[<CommonParameters>]
AuthConfigSettings
Set-AuthConfig
[-Realm <String>]
[-ServiceName <String>]
[-Confirm]
[-DomainController <Fqdn>]
[-WhatIf]
[<CommonParameters>]
Описание
Параметр Set-AuthConfig определяет Microsoft Exchange как партнерское приложение для проверки подлинности между серверами с помощью других партнерских приложений, таких как Microsoft SharePoint 2013 и Microsoft Lync 2013 или Skype для бизнеса Server 2015, включая сертификат, используемый для подписи маркеров. Как правило, для изменения этой конфигурации не требуется, за исключением некоторых случаев, когда необходимо использовать другой сертификат вместо самозаверяющего сертификата, созданного программой установки Exchange, или использовать новый сертификат после истечения срока действия старого.
Для его запуска необходимо получить соответствующие разрешения. Хотя в этой статье перечислены все параметры командлета, у вас может не быть доступа к некоторым параметрам, если они не включены в назначенные вам разрешения. Сведения о необходимых разрешениях для запуска командлетов и использования параметров в организации см. в статье Find the permissions required to run any Exchange cmdlet.
Примеры
Пример 1
Set-AuthConfig -NewCertificateThumbprint DB821B4FCA2A5DA9593B9DE00C86BC5EA35D0FC0 -NewCertificateEffectiveDate 4/17/2014
В этом примере указывается новый сертификат и дата вступления сертификата в силу.
Пример 2
Set-AuthConfig -PublishCertificate
В этом примере происходит немедленное развертывание сертификата, настроенного в качестве следующего, и он становится текущим. Должен быть установлен сертификат, помеченный как следующий.
Параметры
-CertificateThumbprint
Применимо: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Параметр CertificateThumbprint указывает отпечаток сертификата, который будет использоваться Exchange для проверки подлинности между серверами.
Свойства параметров
| Тип: | String |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
CurrentCertificateParameter
| Position: | Named |
| Обязательно: | True |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-ClearPreviousCertificate
Применимо: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Переключатель ClearPreviousCertificate очищает сертификат, сохраненный как предыдущий сертификат в конфигурации авторизации. С этим параметром не нужно указывать значение.
Свойства параметров
| Тип: | SwitchParameter |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
PublishAuthCertificateParameter
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Confirm
Применимо: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Переключатель подтверждения указывает, показывать или скрывать запрос подтверждения. То, как этот переключатель влияет на командлет, зависит от того, требует ли командлет подтверждения перед продолжением.
- Деструктивные командлеты (например, командлеты Remove-) имеют встроенную паузу, которая заставляет вас подтвердить команду перед продолжением. Можно пропускать запросы на подтверждение этих командлетов, используя следующий синтаксис:
-Confirm:$false. - Большинство других командлетов (например, командлеты New- и Set-) не имеют встроенной паузы. Для этих командлетов указание параметра Confirm без значения приводит к паузе, которая вынуждает вас подтвердить команду перед продолжением.
Свойства параметров
| Тип: | SwitchParameter |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | cf |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-DomainController
Применимо: Exchange Server 2013, 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 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Переключатель "Принудительно" скрывает сообщения с предупреждениями или подтверждениями. Указывать значение для этого параметра необязательно.
Этот параметр можно применять для программного выполнения задач, не требующего вмешательства администратора.
Свойства параметров
| Тип: | SwitchParameter |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
CurrentCertificateParameter
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
PublishAuthCertificateParameter
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
NewCertificateParameter
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-NewCertificateEffectiveDate
Применимо: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Параметр NewCertificateEffectiveDate указывает дату, с которой следует использовать сертификат, настроенный как следующий.
Свойства параметров
| Тип: | DateTime |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
NewCertificateParameter
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-NewCertificateThumbprint
Применимо: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Параметр NewCertificateThumbprint указывает отпечаток нового сертификата, который следует использовать в качестве нового в настройках проверки подлинности.
Свойства параметров
| Тип: | String |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
NewCertificateParameter
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-PublishCertificate
Применимо: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Переключатель PublishCertificate немедленно меняет указанный сертификат в качестве текущего сертификата. С этим параметром не нужно указывать значение.
Этот сертификат немедленно развертывается на всех серверах клиентского доступа.
Свойства параметров
| Тип: | SwitchParameter |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
PublishAuthCertificateParameter
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Realm
Применимо: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Параметр Realm указывает область безопасности для партнерских приложений. Если служба или пользователь представляет маркер из домена, который не является допустимым в организации Exchange, для получения доступа к ресурсам маркер должен содержать указанную область.
Свойства параметров
| Тип: | String |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
AuthConfigSettings
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Server
Применимо: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Параметр Server недоступен в этой версии.
Свойства параметров
| Тип: | ServerIdParameter |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
CurrentCertificateParameter
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
NewCertificateParameter
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-ServiceName
Применимо: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Параметр ServiceName идентифицирует Microsoft Exchange с другими партнерскими приложениями, такими как SharePoint 2013.
Программа установки Exchange настраивает параметр ServiceName с определенным постоянным значением. Изменять этот параметр не следует. Изменение параметра ServiceName может привести к проверке подлинности между серверами и неработающим партнерским приложениям.
Свойства параметров
| Тип: | String |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
AuthConfigSettings
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-SkipImmediateCertificateDeployment
Применимо: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Переключатель SkipImmediateCertificateDeployment указывает, что сертификат не следует использовать немедленно. С этим параметром не нужно указывать значение.
Использовать этот переключатель в рабочей среде не рекомендуется.
Свойства параметров
| Тип: | SwitchParameter |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
CurrentCertificateParameter
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
NewCertificateParameter
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-WhatIf
Применимо: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Переключатель WhatIf показывает, что команда делает без каких-либо изменений. С этим параметром не нужно указывать значение.
Свойства параметров
| Тип: | SwitchParameter |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | wi |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
CommonParameters
Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в статье about_CommonParameters.
Входные данные
Input types
Чтобы просмотреть типы входных данных, которые принимает этот командлет, см. Типы входных и выходных данных командлета. Если поле "Типы входных данных" для командлета пусто, командлет не принимает входные данные.
Выходные данные
Output types
Чтобы просмотреть типы возвращаемых данных, также называемые типами вывода, которые принимает этот командлет, см. раздел Типы ввода и вывода командлета. Если поле "Типы выходных данных" пусто, командлет не возвращает данные.