Set-AuthConfig

Este cmdlet está disponível somente no Exchange local.

Use o cmdlet Set-AuthConfig para modificar a configuração de autorização para sua organização do Exchange.

Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.

Syntax

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>]

Description

O parâmetro Set-AuthConfig define Microsoft Exchange como um aplicativo parceiro para autenticação servidor a servidor com outros aplicativos parceiros, como Microsoft SharePoint 2013 e Microsoft Lync 2013 ou Skype for Business Server 2015, incluindo o certificado usado para assinar tokens. Geralmente, não é necessário que essa configuração seja modificada, exceto em alguns casos em que você deve usar um certificado diferente em vez do certificado autoassinado criado pela Configuração do Exchange ou usar um novo certificado depois que o antigo tiver expirado.

Para executar esse cmdlet, você precisa ter permissões. Embora este tópico liste todos os parâmetros do cmdlet, talvez você não tenha acesso a alguns parâmetros se eles não estiverem incluídos nas permissões atribuídas a você. Para localizar as permissões necessárias para executar qualquer cmdlet ou parâmetro em sua organização, confira Find the permissions required to run any Exchange cmdlet.

Exemplos

Exemplo 1

Set-AuthConfig -NewCertificateThumbprint DB821B4FCA2A5DA9593B9DE00C86BC5EA35D0FC0 -NewCertificateEffectiveDate 4/17/2014

Este exemplo especifica um novo certificado e uma data a partir da qual o certificado terá efeito.

Exemplo 2

Set-AuthConfig -PublishCertificate

Este exemplo imediatamente estende o certificado configurado como o certificado seguinte e faz dele o certificado atual. Você precisar ter instalado um certificado marcado como o certificado seguinte.

Parâmetros

-CertificateThumbprint

O parâmetro CertificateThumbprint especifica a impressão digital do certificado a ser usado pelo Exchange para autenticação servidor a servidor.

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

A opção ClearPreviousCertificate limpa o certificado que foi salvo como o certificado anterior na configuração de autorização. Não é preciso especificar um valor com essa opção.

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

A opção Confirm especifica se a solicitação de confirmação deve ser mostrada ou ocultada. Como essa opção afeta o cmdlet dependerá do fato de o cmdlet exigir ou não confirmação antes de continuar.

  • Cmdlets destrutivos (por exemplo, cmdlets Remove-*) têm uma pausa interna que força você a reconhecer o comando antes de prosseguir. Para estes cmdlets, você pode pular o pedido de confirmação usando esta sintaxe exata: -Confirm:$false.
  • A maioria dos outros cmdlets (por exemplo, cmdlets New-* e Set-*) não tem uma pausa interna. Para esses cmdlets, especificar a opção Confirm sem um valor introduz uma pausa que força você a confirmar o comando antes de continuar.
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

O parâmetro DomainController especifica o controlador de domínio que é usado por esse cmdlet para ler dados ou gravar dados no Active Directory. Você identifica o controlador de domínio por seu FQDN (nome de domínio totalmente qualificado). Por exemplo, 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

A opção Forçar oculta mensagens de aviso ou confirmação. Não é preciso especificar um valor com essa opção.

Você pode usar essa opção para executar tarefas de modo programático onde a solicitação por entrada administrativa é inadequada.

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

O parâmetro NewCertificateEffectiveDate especifica uma data quando o certificado configurado como o certificado seguinte deve ser usado.

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

O parâmetro NewCertificateThumbprint especifica a impressão digital do novo certificado a ser usado como o certificado seguinte na configuração de autorização.

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

A opção PublishCertificate passa imediatamente sobre o certificado especificado como o certificado atual. Não é preciso especificar um valor com essa opção.

O certificado é implantado imediatamente em todos os servidores de Acesso para Cliente.

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

O parâmetro Realm especifica um realm de segurança para aplicativos parceiros. Se um serviço ou usuário apresentar um token de um domínio que não é um domínio aceito na organização exchange, o token deverá conter o reino especificado para obter acesso aos recursos.

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

O parâmetro Server não está disponível nesta versão.

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

O parâmetro ServiceName identifica Microsoft Exchange para outros aplicativos parceiros, como o SharePoint 2013.

A Configuração do Exchange configura o parâmetro ServiceName com um valor constante específico. Não modifique esse parâmetro. Alterar o parâmetro ServiceName pode resultar no não funcionamento da autenticação de servidor para servidor com os aplicativos parceiros.

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

A opção SkipImmediateCertificateDeployment especifica que o certificado não deve ser usado imediatamente. Não é preciso especificar um valor com essa opção.

Nós não recomendamos usar essa opção em um ambiente de produção.

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

A opção WhatIf simula as ações do comando. Você pode usar essa opção para exibir as alterações que ocorreriam sem realmente aplicar essas alterações. Não é preciso especificar um valor com essa opção.

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

Entradas

Input types

Para ver os tipos de entrada que este cmdlet aceita, confira Tipos de entrada e saída de cmdlet. Se o campo Tipo de Entrada de um cmdlet estiver em branco, isso significa que o cmdlet não aceita dados de entrada.

Saídas

Output types

Para ver os tipos de retorno, também conhecidos como tipos de saída, que este cmdlet aceita, consulte Tipos de entrada e saída de cmdlet. Se o campo Tipo de Saída estiver em branco, o cmdlet não retorna dados.