Set-OutlookAnywhere

Módulo:: Exchange PowerShell

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

Use o cmdlet Set-OutlookAnywhere para modificar os diretórios virtuais do Outlook em Qualquer Lugar usados no IIS (Serviços de Informações da Internet) em servidores Microsoft Exchange. O Outlook em Qualquer Lugar 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.

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 você pode ver neste artigo, consulte Noções básicas sobre autenticação HTTP.

Para executar esse cmdlet, você precisa ter permissões. Embora este artigo 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 servidor de Acesso para Cliente CAS01.

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 Outlook em Qualquer Lugar 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 em Qualquer Lugar no servidor chamado EXCH1. Essa configuração informa ao Outlook em Qualquer Lugar que não espera descriptografia TLS entre os clientes e o servidor e habilita a configuração "Exigir SSL" no diretório virtual. Como o TLS agora é necessário para conexões Outlook em Qualquer Lugar, precisamos configurar clientes internos e externos para usar 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 configuração do diretório virtual do Outlook em Qualquer Lugar do 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 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 IIS para lidar com a autenticação de vários aplicativos que exigem métodos de autenticação diferentes.

Parâmetros

-ClientAuthenticationMethod

O parâmetro ClientAuthenticationMethod especifica o método de autenticação que o serviço de Descoberta Automática fornece aos clientes do Outlook em Qualquer Lugar para autenticar no servidor de Acesso para 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.

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

A opção Confirm especifica se a solicitação de confirmação deve ser mostrada ou ocultada. A forma como essa opção 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 esses cmdlets, especificar a opção Confirm sem um valor introduz uma pausa que força você 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

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

Básica
NTLM
Negociar

Não é possível usar esse 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

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

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: necessário se você quiser usar valores de SPN (Nome da Entidade de Serviço) que não contêm 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 os certificados sem ponto não são exclusivos, portanto, não é possível garantir que a conexão de cliente para proxy foi estabelecida em um canal seguro.
NoServiceNameCheck: a lista de SPNs não é verificada 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 TLS. 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 para 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

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 valor é o padrão.
SPN único ou lista delimitada por vírgulas de SPNs válidos: O formato de valor do 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.

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

O parâmetro ExtendedProtectionTokenChecking especifica se a Proteção Estendida para Autenticação é usada para conexões de cliente com o diretório virtual. Os valores válidos são:

Nenhum: a Proteção Estendida para Autenticação não é usada para conexões de cliente com o diretório virtual. Esse valor é o padrão.
Permitir: a Proteção Estendida para Autenticação será usada para conexões de cliente com o diretório virtual se o cliente e o servidor a suportarem.
Exigir: a Proteção Estendida para Autenticação é necessária para conexões de cliente com o diretório virtual. Se o cliente ou servidor não for compatível, a conexão falhará. Esse valor também requer um valor de SPN (Nome da Entidade de Serviço) para o parâmetro ExtendedProtectionSPNList.

Observação: se um servidor proxy na frente do servidor Exchange encerrar o canal TLS (Transport Layer Security) de cliente para proxy, os valores Permitir ou Exigir precisarão de um ou mais valores de 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

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 (valor padrão)

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

O parâmetro ExternalClientsRequireSsl especifica se os clientes externos do Outlook em Qualquer Lugar são necessários para usar o protocolo TLS. Os valores válidos são:

$true: os clientes que se conectam via Outlook de fora da organização devem usar o TLS.
$false: Os clientes que se conectam via Outlook Em qualquer lugar de fora da organização não são obrigados a usar TLS. Esse valor é o padrã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

O parâmetro ExternalHostname especifica o nome de host externo para o diretório virtual do Outlook em Qualquer Lugar. 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

O parâmetro Identity especifica o diretório virtual do Outlook em Qualquer Lugar 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 Nome 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*.

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

O parâmetro IISAuthenticationMethods especifica o método de autenticação usado no diretório virtual do Outlook em Qualquer Lugar 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

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

Básica
NTLM (valor padrão)
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

O parâmetro InternalClientsRequireSsl especifica se os clientes internos do Outlook em Qualquer Lugar são necessários para usar o protocolo TLS. Os valores válidos são:

$true: Os clientes que se conectam via Outlook Em qualquer lugar de dentro da organização são obrigados a usar TLS.
$false: os clientes que se conectam via Outlook Em qualquer lugar de dentro da organização não são obrigados a usar TLS. Esse valor é o padrã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

O parâmetro InternalHostname especifica o nome do host interno para o diretório virtual do Outlook em Qualquer Lugar. 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

O parâmetro Name especifica o nome do diretório virtual do Outlook em Qualquer Lugar. 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

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

$true: Os clientes do Outlook em Qualquer Lugar que usam TLS não mantêm uma conexão TLS ao longo de todo o caminho de rede para o servidor Exchange. Um dispositivo de rede na frente do servidor descriptografa as conexões TLS e faz proxy das conexões de cliente não criptografadas (HTTP) para o diretório virtual do Outlook em Qualquer Lugar. O segmento de rede em que o HTTP é usado deve ser uma rede segura.
$false: Os clientes do Outlook em Qualquer Lugar que usam TLS mantêm uma conexão TLS ao longo de todo o caminho de rede para o servidor Exchange. Apenas conexões TLS têm permissão para acessar o diretório virtual do Outlook em Qualquer Lugar. Esse valor é o padrão.

Esse parâmetro define a configuração "Exigir SSL" no diretório virtual do Outlook em Qualquer Lugar. Quando você define este parâmetro como $true, "Exigir SSL" é desabilitado. Quando você define este parâmetro como $false, "Exigir SSL" é habilitado. No entanto, pode levar vários minutos para que a alteração fique visível no Gerenciador do IIS.

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

O valor desse parâmetro está relacionado aos 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

A opção WhatIf mostra o que o comando faz sem fazer nenhuma alteração. 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 dá suporte aos 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.

Comentários

Esta página foi útil?