Set-OutlookAnywhere

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

Utilize o cmdlet Set-OutlookAnywhere para modificar os diretórios virtuais do Outlook Anywhere que são utilizados nos Serviços de Informação Internet (IIS) nos servidores do Microsoft Exchange. O Outlook Anywhere utiliza 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.

Sintaxe

Default (Default)

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 pode ver neste artigo, veja Understanding HTTP Authentication (Compreender a Autenticação HTTP).

Para executar esse cmdlet, você precisa ter permissões. Embora este artigo liste todos os parâmetros do cmdlet, poderá não ter acesso a alguns parâmetros se não estiverem incluídos nas permissões que lhe foram atribuídas. 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 de cliente como NTLM para o diretório virtual /rpc no servidor de Acesso de Cliente CAS01.

Exemplo 2

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

Este exemplo define o método de autenticação de cliente como NTLM para o diretório virtual do Outlook Anywhere no servidor com o nome 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 com o nome EXCH1. Esta definição informa o Outlook Anywhere de não esperar qualquer desencriptação TLS entre os clientes e o servidor e ativa a definição "Exigir SSL" no diretório virtual. Uma vez que o TLS é agora necessário para as ligações do Outlook Anywhere, temos de configurar clientes internos e externos para utilizar o TLS.

Exemplo 4

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

Este exemplo define o método de autenticação para a definição de diretório virtual do Outlook Anywhere no IIS para 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 definição de diretório virtual /rpc no IIS para utilizar a autenticação Básica e NTLM. Depois de definir este valor, pode utilizar o diretório virtual do IIS para processar a autenticação de várias aplicações que requerem métodos de autenticação diferentes.

Parâmetros

-ClientAuthenticationMethod

Aplicável: Exchange Server 2010

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

  • Básica
  • Ntlm

Embora possa utilizar este parâmetro para definir apenas um método de autenticação, o comando não devolve um erro se incluir vários valores.

Propriedades do parâmetro

Tipo:AuthenticationMethod
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Confirm

Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

A opção Confirm especifica se a solicitação de confirmação deve ser mostrada ou ocultada. A forma como este comutador afeta o cmdlet depende se o cmdlet requer confirmação antes de continuar.

  • Cmdlets destrutivos (por exemplo, Remover- cmdlets) têm uma pausa interna que força você a confirmar o comando antes de continuar. Para estes cmdlets, você pode pular o pedido de confirmação usando esta sintaxe exata: -Confirm:$false.
  • A maioria dos outros cmdlets (por exemplo, New- e Set-) não tem uma pausa interna. Para estes cmdlets, especificar o comutador Confirmar sem um valor introduz uma pausa que o obriga a reconhecer o comando antes de continuar.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:cf

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-DefaultAuthenticationMethod

Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

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

  • Básica
  • Ntlm
  • Negociar

Não pode utilizar este parâmetro com os parâmetros ExternalClientAuthenticationMethod, InternalClientAuthenticationMethod e IISAuthenticationMethods.

Propriedades do parâmetro

Tipo:AuthenticationMethod
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-DomainController

Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

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.

Propriedades do parâmetro

Tipo:Fqdn
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-ExtendedProtectionFlags

Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

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

  • Nenhuma: Esta é a configuração padrão.
  • AllowDotlessSPN: necessário se quiser utilizar valores de Nome Principal de Serviço (SPN) que não contenham FQDNs (por exemplo, HTTP/ContosoMail em vez de HTTP/mail.contoso.com). Especifique SPNs com o parâmetro ExtendedProtectionSPNList. Esta definição torna a Proteção Expandida para Autenticação menos segura porque os certificados sem pontos não são exclusivos, pelo que não é possível garantir que a ligação cliente a proxy foi estabelecida através de um canal seguro.
  • NoServiceNameCheck: a lista SPN não está selecionada para validar um token de enlace de canal. Esta definição torna a Proteção Expandida para Autenticação menos segura. Geralmente, essa configuração não é recomendada.
  • Proxy: um servidor proxy é responsável por terminar o canal TLS. Para utilizar esta definição, tem de registar um SPN com o parâmetro ExtendedProtectionSPNList.
  • ProxyCoHosting: o tráfego HTTP e HTTPS pode estar a aceder ao diretório virtual e um servidor proxy está localizado entre, pelo menos, alguns dos clientes e os serviços de Acesso de Cliente no servidor Exchange.

Propriedades do parâmetro

Tipo:MultiValuedProperty
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-ExtendedProtectionSPNList

Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

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

  • $null: este valor é a predefinição.
  • SPN único ou lista delimitada por vírgulas de SPNs válidos: 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), também tem de utilizar o valor AllowDotlessSPN para o parâmetro ExtendedProtectionFlags.

Propriedades do parâmetro

Tipo:MultiValuedProperty
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-ExtendedProtectionTokenChecking

Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

O parâmetro ExtendedProtectionTokenChecking especifica se a Proteção Expandida para Autenticação é utilizada para ligações de cliente ao diretório virtual. Os valores válidos são:

  • Nenhuma: a Proteção Expandida para Autenticação não é utilizada para ligações de cliente ao diretório virtual. Este valor é a predefinição.
  • Permitir: a Proteção Expandida para Autenticação é utilizada para ligações de cliente ao diretório virtual se o cliente e o servidor o suportarem.
  • Exigir: a Proteção Alargada para Autenticação é necessária para as ligações de cliente ao diretório virtual. Se o cliente ou servidor não o suportar, a ligação falhará. Este valor também requer um valor de Nome Principal de Serviço (SPN) para o parâmetro ExtendedProtectionSPNList.

Nota: se um servidor proxy à frente do servidor Exchange terminar o canal TLS (Transport Layer Security) cliente para proxy, os valores Permitir ou Exigir precisam de um ou mais valores SPN para o parâmetro ExtendedProtectionSPNList.

Propriedades do parâmetro

Tipo:ExtendedProtectionTokenCheckingMode
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-ExternalClientAuthenticationMethod

Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

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

  • Básica
  • Ntlm
  • Negociar (valor predefinido)

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

Propriedades do parâmetro

Tipo:AuthenticationMethod
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-ExternalClientsRequireSsl

Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

O parâmetro ExternalClientsRequireSsl especifica se os clientes externos do Outlook Anywhere são necessários para utilizar o Transport Layer Security (TLS). Os valores válidos são:

  • $true: os clientes que se ligam através do Outlook Anywhere de fora da organização têm de utilizar o TLS.
  • $false: os clientes que se ligam através do Outlook Anywhere de fora da organização não são obrigados a utilizar o TLS. Este valor é a predefinição.

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

Propriedades do parâmetro

Tipo:Boolean
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-ExternalHostname

Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

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

Propriedades do parâmetro

Tipo:Hostname
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Identity

Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

O parâmetro Identity especifica o diretório virtual do Outlook Anywhere que pretende 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 Nome utiliza a sintaxe "VirtualDirectoryName (WebsiteName)" das propriedades do diretório virtual. Pode especificar o caráter universal (*) em vez do site predefinido com a sintaxe VirtualDirectoryName*.

Propriedades do parâmetro

Tipo:VirtualDirectoryIdParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:1
Obrigatório:True
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-IISAuthenticationMethods

Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

O parâmetro IISAuthenticationMethods especifica o método de autenticação utilizado 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.

Propriedades do parâmetro

Tipo:MultiValuedProperty
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-InternalClientAuthenticationMethod

Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

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

  • Básica
  • Ntlm (valor predefinido)
  • Negociar

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

Propriedades do parâmetro

Tipo:AuthenticationMethod
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-InternalClientsRequireSsl

Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

O parâmetro InternalClientsRequireSsl especifica se os clientes internos do Outlook Anywhere são necessários para utilizar o Transport Layer Security (TLS). Os valores válidos são:

  • $true: os clientes que se ligam através do Outlook Anywhere a partir da organização têm de utilizar o TLS.
  • $false: os clientes que se ligam através do Outlook Anywhere a partir da organização não são obrigados a utilizar o TLS. Este valor é a predefinição.

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

Propriedades do parâmetro

Tipo:Boolean
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-InternalHostname

Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

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

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Name

Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

O parâmetro Nome 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 (").

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-SSLOffloading

Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

O parâmetro SSLOffloading especifica se um dispositivo de rede aceita ligações TLS (Transport Layer Security) e as desencripta antes de criar o proxy das ligações para o diretório virtual do Outlook Anywhere no servidor Exchange. Os valores válidos são:

  • $true: os clientes do Outlook Anywhere que utilizam o TLS não mantêm uma ligação TLS ao longo de todo o caminho de rede para o servidor Exchange. Um dispositivo de rede à frente do servidor desencripta as ligações TLS e proxies as ligações de cliente (HTTP) não encriptadas para o diretório virtual do Outlook Anywhere. O segmento de rede onde é utilizado HTTP deve ser uma rede segura.
  • $false: os clientes do Outlook Anywhere que utilizam o TLS mantêm uma ligação TLS ao longo de todo o caminho de rede para o servidor Exchange. Apenas as ligações TLS são permitidas para o diretório virtual do Outlook Anywhere. Este valor é a predefinição.

Este parâmetro configura a definição "Exigir SSL" no diretório virtual do Outlook Anywhere. Quando define este parâmetro como $true, "Exigir SSL" é desativado. Quando define este parâmetro como $false, "Exigir SSL" é ativado. No entanto, poderá demorar vários minutos até que a alteração seja visível no Gestor do IIS.

Tem de utilizar o valor $true para este parâmetro se não precisar de ligações TLS para clientes internos ou externos do Outlook Anywhere.

O valor deste parâmetro está relacionado com os valores dos parâmetros ExternalClientsRequireSsl e InternalClientsRequireSsl.

Propriedades do parâmetro

Tipo:Boolean
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-WhatIf

Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

O parâmetro WhatIf mostra o que o comando faz sem efetuar alterações. Não é preciso especificar um valor com essa opção.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:wi

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, confira about_CommonParameters.

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.