Set-OutlookAnywhere

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

Use o cmdlet Set-OutlookAnywhere para modificar diretórios virtuais do Outlook Anywhere que são usados no IIS (Serviços de Informações da Internet) em servidores do Exchange Microsoft. O Outlook Anywhere usa diretórios virtuais que contêm "rpc" no nome.

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

Syntax

Set-OutlookAnywhere
   [-Identity] <VirtualDirectoryIdParameter>
   [-ClientAuthenticationMethod <AuthenticationMethod>]
   [-Confirm]
   [-DefaultAuthenticationMethod <AuthenticationMethod>]
   [-DomainController <Fqdn>]
   [-ExtendedProtectionFlags <MultiValuedProperty>]
   [-ExtendedProtectionSPNList <MultiValuedProperty>]
   [-ExtendedProtectionTokenChecking <ExtendedProtectionTokenCheckingMode>]
   [-ExternalClientAuthenticationMethod <AuthenticationMethod>]
   [-ExternalClientsRequireSsl <Boolean>]
   [-ExternalHostname <Hostname>]
   [-IISAuthenticationMethods <MultiValuedProperty>]
   [-InternalClientAuthenticationMethod <AuthenticationMethod>]
   [-InternalClientsRequireSsl <Boolean>]
   [-InternalHostname <String>]
   [-Name <String>]
   [-SSLOffloading <Boolean>]
   [-WhatIf]
   [<CommonParameters>]

Description

Para obter mais informações sobre os diferentes métodos de autenticação que você pode ver neste artigo, consulte Compreensão da Autenticação HTTP.

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-OutlookAnywhere -Identity:CAS01\Rpc (Default Web Site) -ClientAuthenticationMethod:Ntlm

No Exchange 2010, este exemplo define o método de autenticação do cliente como NTLM para o diretório virtual /rpc no CAS01 do servidor de Acesso ao Cliente.

Exemplo 2

Set-OutlookAnywhere -Identity: "EXCH1\rpc (Default Web Site)" -ExternalClientAuthenticationMethod NTLM

Este exemplo define o método de autenticação do cliente como NTLM para o diretório virtual do Outlook Anywhere no servidor chamado EXCH1.

Exemplo 3

Set-OutlookAnywhere -Identity "EXCH1\rpc (Default Web Site)" -SSLOffloading $false -InternalClientsRequireSsl $true -ExternalClientsRequireSsl $true

Este exemplo define o parâmetro SSLOffloading como $false para o diretório virtual do Outlook Anywhere no servidor chamado EXCH1. Essa configuração informa o Outlook Anywhere para não esperar nenhuma descriptografia SSL entre clientes e o servidor e habilita o valor Exigir SSL no diretório virtual. Como o SSL agora é necessário para conexões do Outlook Anywhere, precisamos configurar clientes internos e externos para usar o SSL.

Exemplo 4

Set-OutlookAnywhere -Identity "EXCH1\rpc (Default Web Site)" -IISAuthenticationMethods NTLM

Este exemplo define o método de autenticação para a configuração de diretório virtual do Outlook Anywhere no IIS como NTLM.

Exemplo 5

Set-OutlookAnywhere -Identity "EXCH1\rpc (Default Web Site)" -IISAuthenticationMethods Basic,NTLM

No Exchange 2010 e no Exchange 2013, este exemplo define os métodos de autenticação disponíveis para a configuração do diretório virtual /rpc no IIS para usar a autenticação Básica e NTLM. Depois de definir esse valor, você pode usar o diretório virtual do IIS para lidar com a autenticação de vários aplicativos que exigem métodos de autenticação diferentes.

Parâmetros

-ClientAuthenticationMethod

Esse parâmetro só está disponível no Exchange Server 2010.

O parâmetro ClientAuthenticationMethod especifica o método de autenticação que o serviço Autodiscover fornece aos clientes do Outlook Anywhere para autenticar no servidor de Acesso ao Cliente. Os valores válidos são:

  • Básica
  • Ntlm

Embora você possa usar esse parâmetro para definir apenas um método de autenticação, o comando não retornará um erro se você incluir vários valores.

Type:AuthenticationMethod
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

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

-DefaultAuthenticationMethod

O parâmetro DefaultAuthenticationMethod especifica o método de autenticação padrão para Outlook Anywhere. Esse parâmetro substitui os valores de propriedade ExternalClientAuthenticationMethod, InternalClientAuthenticationMethod e IISAuthenticationMethods pelo valor especificado. Os valores válidos são:

  • Básica
  • Ntlm
  • Negociar

Você não pode usar esse parâmetro com os parâmetros ExternalClientAuthenticationMethod, InternalClientAuthenticationMethod e IISAuthenticationMethods.

Type:AuthenticationMethod
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, 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 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-ExtendedProtectionFlags

O parâmetro ExtendedProtectionFlags especifica configurações personalizadas para Proteção Estendida para Autenticação no diretório virtual. Os valores válidos são:

  • Nenhuma: Esta é a configuração padrão.
  • AllowDotlessSPN: obrigatório se você quiser usar valores SPN (Nome da Entidade de Serviço) que não contenham FQDNs (por exemplo, HTTP/ContosoMail em vez de HTTP/mail.contoso.com). Você especifica SPNs com o parâmetro ExtendedProtectionSPNList. Essa configuração torna a Proteção Estendida para Autenticação menos segura porque certificados sem ponto não são exclusivos, portanto, não é possível garantir que a conexão cliente-proxy tenha sido estabelecida em um canal seguro.
  • NoServiceNameCheck: a lista SPN não está marcada para validar um token de associação de canal. Essa configuração torna a Proteção Estendida para Autenticação menos segura. Geralmente, essa configuração não é recomendada.
  • Proxy: um servidor proxy é responsável por encerrar o canal SSL. Para usar essa configuração, você precisa registrar um SPN usando o parâmetro ExtendedProtectionSPNList.
  • ProxyCoHosting: o tráfego HTTP e HTTPS pode estar acessando o diretório virtual e um servidor proxy está localizado entre pelo menos alguns dos clientes e os serviços de Acesso ao Cliente no servidor exchange.
Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-ExtendedProtectionSPNList

O parâmetro ExtendedProtectionSPNList especifica uma lista de SPNs (Nomes de Entidade de Serviço) válidos se você estiver usando a Proteção Estendida para Autenticação no diretório virtual. Os valores válidos são:

  • $null: esse é o valor padrão.
  • SPN único ou lista delimitada por vírgulas de SPNs válidas: o formato de valor SPN é Protocol\FQDN. Por exemplo, HTTP/mail.contoso.com. Para adicionar um SPN que não seja um FQDN (por exemplo, HTTP/ContosoMail), você também precisa usar o valor AllowDotlessSPN para o parâmetro ExtendedProtectionFlags.
Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-ExtendedProtectionTokenChecking

O parâmetro ExtendedProtectionTokenChecking define como você deseja usar a Proteção Estendida para Autenticação no diretório virtual. A Proteção Estendida para Autenticação não está habilitada por padrão. Os valores válidos são:

  • Nenhum: Proteção Estendida para Autenticação não é usada no diretório virtual. Esse é o valor padrão.
  • None: a Proteção Estendida para Autenticação não é usada no diretório virtual. Este é o valor padrão.
  • Exigir: Proteção Estendida para Autenticação é usada para todas as conexões entre clientes e o diretório virtual. Se o cliente ou o servidor não der suporte a ele, a conexão falhará. Se você usar esse valor, também precisará definir um valor SPN para o parâmetro ExtendedProtectionSPNList.

Observação: se você usar o valor Permitir ou Exigir e tiver um servidor proxy entre o cliente e os serviços de Acesso ao Cliente no servidor da caixa de correio configurado para encerrar o canal SSL cliente a proxy, você também precisará configurar um ou mais SPNs (Nomes de Entidade de Serviço) usando o parâmetro ExtendedProtectionSPNList.

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

-ExternalClientAuthenticationMethod

O parâmetro ExternalClientAuthenticationMethod especifica o método de autenticação usado para autenticar clientes externos do Outlook Anywhere. Os valores válidos são:

  • Básica
  • Ntlm
  • Negociar (esse é o valor padrão)

Você não pode usar esse parâmetro com o parâmetro DefaultAuthenticationMethods.

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

-ExternalClientsRequireSsl

O parâmetro ExternalClientsRequireSsl especifica se os clientes externos do Outlook Anywhere são necessários para usar a SSL (Secure Sockets Layer). Os valores válidos são:

  • $true: os clientes que se conectam via Outlook em qualquer lugar de fora da organização são necessários para usar o SSL.
  • $false: os clientes que se conectam via Outlook em qualquer lugar de fora da organização não são necessários para usar o SSL. Esse é o valor padrão.

O valor deste parâmetro está relacionado ao valor do parâmetro SSLOffloading.

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

-ExternalHostname

O parâmetro ExternalHostname especifica o nome do host externo para o diretório virtual do Outlook Anywhere. Por exemplo, mail.contoso.com.

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

-Identity

O parâmetro Identity especifica o diretório virtual do Outlook Anywhere que você deseja modificar. É possível usar qualquer valor que identifique exclusivamente o diretório virtual. Por exemplo:

  • Nome ou Servidor\Nome
  • DN (nome diferenciado)
  • GUID

O valor Name usa a sintaxe "VirtualDirectoryName (WebsiteName)" das propriedades do diretório virtual. Você pode especificar o caractere curinga (*) em vez do site padrão usando a sintaxe VirtualDirectoryName*.

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

-IISAuthenticationMethods

O parâmetro IISAuthenticationMethods especifica o método de autenticação usado no diretório virtual do Outlook Anywhere no IIS. Os valores válidos são:

  • Básica
  • Ntlm
  • Negociar

Você pode especificar vários valores separados por vírgulas. Por padrão, todos os valores são usados.

Você não pode usar esse parâmetro com o parâmetro DefaultAuthenticationMethods.

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

-InternalClientAuthenticationMethod

O parâmetro InternalClientAuthenticationMethod especifica o método de autenticação usado para autenticar clientes internos do Outlook Anywhere. Os valores válidos são:

  • Básica
  • Ntlm (esse é o valor padrão)
  • Negociar

Você não pode usar esse parâmetro com o parâmetro DefaultAuthenticationMethods.

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

-InternalClientsRequireSsl

O parâmetro InternalClientsRequireSsl especifica se os clientes internos do Outlook Anywhere são necessários para usar o SSL. Os valores válidos são:

  • $true: os clientes que se conectam via Outlook em qualquer lugar de dentro da organização são necessários para usar o SSL.
  • $false: os clientes que se conectam via Outlook em qualquer lugar de dentro da organização não são necessários para usar o SSL. Esse é o valor padrão.

O valor deste parâmetro está relacionado ao valor do parâmetro SSLOffloading.

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

-InternalHostname

O parâmetro InternalHostname especifica o nome do host interno para o diretório virtual do Outlook Anywhere. Por exemplo, mail.contoso.com.

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

-Name

O parâmetro Name especifica o nome do diretório virtual do Outlook Anywhere. O valor padrão é Rpc (Default Web Site). Se o valor especificado contiver espaços, coloque-o entre aspas (").

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

-SSLOffloading

O parâmetro SSLOffloading especifica se um dispositivo de rede aceita conexões SSL e as descriptografa antes de fazer proxy das conexões com o diretório virtual do Outlook Anywhere no servidor exchange. Os valores válidos são:

  • $true: os clientes do Outlook Anywhere usando o SSL não mantêm uma conexão SSL ao longo de todo o caminho de rede para o servidor exchange. Um dispositivo de rede na frente do servidor descriptografa as conexões SSL e proxie as conexões de cliente HTTP (não criptografadas) para o diretório virtual do Outlook Anywhere. O segmento de rede em que o HTTP é usado deve ser uma rede protegida. Esse é o valor padrão.
  • $false: os clientes do Outlook Anywhere usando o SSL mantêm uma conexão SSL ao longo de todo o caminho de rede para o servidor exchange. Somente conexões SSL são permitidas para o diretório virtual do Outlook Anywhere.

Esse parâmetro configura o valor Exigir SSL no diretório virtual do Outlook Anywhere. Quando você define esse parâmetro como $true, Exigir SSL é desabilitado. Quando você define esse parâmetro como $fase, Exigir SSL é habilitado. No entanto, pode levar alguns minutos antes que a alteração é visível no Gerenciador do IIS.

Você precisa usar o valor $true para esse parâmetro se não precisar de conexões SSL para clientes internos ou externos do Outlook Anywhere.

O valor desse parâmetro está relacionado aos valores dos parâmetros ExternalClientsRequireSsl e InternalClientsRequireSsl.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, 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 2010, 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.