Set-MapiVirtualDirectory

A opção ApplyDefaults especifica se os padrões corretos deverão ser aplicados às configurações de aplicativo IIS interno relacionadas. Normalmente, essa opção é usada apenas pela Instalação do Exchange durante a instalação do Exchange Cumulativo Atualizações ou Service Packs e você não deve precisar usá-lo.

Esta opção não afeta os valores configurados usando os parâmetros IISAuthenticationMethods, InternalUrl ou ExternalUrl.

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.

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.

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.

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.

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

O parâmetro ExternalURL especifica a URL usada para se conectar ao diretório virtual de fora do firewall.

Essa configuração aplica o protocolo SSL (Secure Sockets Layer) e usa a porta SSL padrão. A entrada válida para esse parâmetro usa a sintaxe https://<Domain Name>/mapi(por exemplo, https://external.contoso.com/mapi).

Quando você usa os parâmetros InternalUrl ou ExternalUrl, é necessário especificar um ou mais valores de autenticação usando o parâmetro IISAuthenticationMethods.

O parâmetro Identity especifica o diretório virtual MAPI 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*.

O parâmetro IISAuthenticationMethods especifica os métodos de autenticação habilitados no diretório virtual no IIS (Serviços de Informações da Internet). Os valores válidos são:

• Básica
• Negociar
• NTLM
• OAuth

Vários valores, separados por vírgulas, podem ser especificados.

Os valores padrão são NTLM, OAuth e Negotiate. Recomendamos que você sempre tenha o diretório virtual configurado para OAuth.

Para obter mais informações sobre os diferentes métodos de autenticação, consulte Noções básicas sobre autenticação HTTP e o que é a autenticação OAuth?.

O parâmetro InternalURLespecifica a URL usada para se conectar ao diretório virtual de dentro do firewall.

Essa configuração aplica o protocolo SSL (Secure Sockets Layer) e usa a porta SSL padrão. A entrada válida para esse parâmetro usa a sintaxe https://<Domain Name>/mapi (por exemplo, https://internal.contoso.com/mapi).

Quando você usa os parâmetros InternalUrl ou ExternalUrl, é necessário especificar um ou mais valores de autenticação usando o parâmetro IISAuthenticationMethods.

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.