Set-AuthConfig

Ссылка

Модуль:: ExchangePowerShell

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

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

Используйте командлет Set-AuthConfig, чтобы изменить конфигурацию авторизации для организации Exchange.

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

Синтаксис

Set-AuthConfig
   -CertificateThumbprint <String>
   [-SkipImmediateCertificateDeployment]
   [-Confirm]
   [-DomainController <Fqdn>]
   [-Force]
   [-Server <ServerIdParameter>]
   [-WhatIf]
   [<CommonParameters>]

Set-AuthConfig
   [-ClearPreviousCertificate]
   [-PublishCertificate]
   [-Confirm]
   [-DomainController <Fqdn>]
   [-Force]
   [-WhatIf]
   [<CommonParameters>]

Set-AuthConfig
   [-NewCertificateEffectiveDate <DateTime>]
   [-NewCertificateThumbprint <String>]
   [-SkipImmediateCertificateDeployment]
   [-Confirm]
   [-DomainController <Fqdn>]
   [-Force]
   [-Server <ServerIdParameter>]
   [-WhatIf]
   [<CommonParameters>]

Set-AuthConfig
   [-Realm <String>]
   [-ServiceName <String>]
   [-Confirm]
   [-DomainController <Fqdn>]
   [-WhatIf]
   [<CommonParameters>]

Описание

Параметр Set-AuthConfig определяет Майкрософт Exchange в качестве партнерского приложения для проверки подлинности между серверами с другими партнерскими приложениями, такими как Майкрософт SharePoint 2013 и Майкрософт 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

Параметр CertificateThumbprint указывает отпечаток сертификата, который будет использоваться Exchange для проверки подлинности между серверами.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-ClearPreviousCertificate

Параметр ClearPreviousCertificate очищает сертификат, сохраненный как предыдущий в конфигурации авторизации. Указывать значение для этого параметра необязательно.

Type:	SwitchParameter
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

-Confirm

Переключатель подтверждения указывает, показывать или скрывать запрос подтверждения. Влияние этого параметра на командлет зависит от того, требуется ли командлету подтверждение перед выполнением.

Деструктивные командлеты (например, командлеты Remove-*) имеют встроенную паузу, которая заставляет вас подтвердить команду перед продолжением. Можно пропускать запросы на подтверждение этих командлетов, используя следующий синтаксис: -Confirm:$false.
Большинство других командлетов (например, командлеты New-* и Set-*) не имеют встроенной приостановки. Для этих командлетов указание переключателя Confirm без значения вводит паузу, которая заставляет вас подтвердить команду перед продолжением.

Type:	SwitchParameter
Aliases:	cf
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

-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 2013, 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 2013, Exchange Server 2016, Exchange Server 2019

-NewCertificateEffectiveDate

Параметр NewCertificateEffectiveDate указывает дату, с которой следует использовать сертификат, настроенный как следующий.

Type:	DateTime
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

-NewCertificateThumbprint

Параметр NewCertificateThumbprint указывает отпечаток нового сертификата, который следует использовать в качестве нового в настройках проверки подлинности.

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

-PublishCertificate

Параметр PublishCertificate немедленно выполняет переключение указанного сертификата в качестве текущего сертификата. Указывать значение для этого параметра необязательно.

Этот сертификат немедленно развертывается на всех серверах клиентского доступа.

Type:	SwitchParameter
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

-Realm

Параметр Realm указывает область безопасности для партнерских приложений. Если служба или пользователь предоставляет маркер из домена, который не является принятым доменом в организации Exchange, маркер должен содержать указанную область для получения доступа к ресурсам.

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

-Server

Параметр Server недоступен в этой версии.

Type:	ServerIdParameter
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

-ServiceName

Параметр ServiceName определяет Майкрософт Exchange для других партнерских приложений, таких как SharePoint 2013.

Программа установки Exchange настраивает параметр ServiceName с определенным константным значением. Этот параметр изменять не следует. Изменение параметра ServiceName может привести к тому, что проверка подлинности между серверами не работает в партнерских приложениях.

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

-SkipImmediateCertificateDeployment

Переключатель SkipImmediateCertificateDeployment указывает, что сертификат не следует использовать немедленно. Указывать значение для этого параметра необязательно.

Использовать этот переключатель в рабочей среде не рекомендуется.

Type:	SwitchParameter
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

-WhatIf

Переключатель WhatIf имитирует действия команды. Вы можете использовать его для просмотра результатов изменений без фактического внесения этих изменений. С этим параметром не нужно указывать значение.

Type:	SwitchParameter
Aliases:	wi
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

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

Input types

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

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

Output types

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

Поделиться через