New-EcpVirtualDirectory

O parâmetro AppPoolId define o pool de aplicativos IIS onde o diretório virtual ECP é executado. É recomendável que esse parâmetro permaneça na configuração padrão.

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 é importante quando a SSL é usada. É preciso definir esse parâmetro para permitir que o serviço de Descoberta Automática retorne a URL do diretório virtual do ECP.

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

Essa configuração é importante quando SSL é usado. É preciso definir esse parâmetro para permitir que o serviço de Descoberta Automática retorne a URL do diretório virtual do ECP.

O parâmetro Path define o caminho do arquivo do sistema do diretório virtual ECP. Esse parâmetro deve ser usado com cuidado e somente quando for necessário usar um caminho do sistema de arquivos diferente do padrão.

O parâmetro Role espécie a configuração para o diretório virtual. Os valores válidos são:

• ClientAccess: configure o diretório virtual para os serviços de acesso ao cliente (front-end) no servidor da caixa de correio.
• Caixa de correio: configure o diretório virtual para os serviços de back-end no servidor da caixa de correio.

As conexões do cliente são proxied dos serviços de Acesso ao Cliente para os serviços de back-end em servidores locais ou remotos da caixa de correio. Os clientes não se conectam diretamente aos serviços de back-end.

O parâmetro Server especifica o servidor exchange que hospeda o diretório virtual. É possível usar qualquer valor que identifique o servidor com exclusividade. Por exemplo:

• Nome
• FQDN
• DN (nome diferenciado)
• ExchangeLegacyDN

Você não pode criar um diretório virtual do ECP remotamente. Só é possível criar um diretório virtual do ECP no computador local.

O parâmetro WebSiteName especifica o nome do site do IIS no qual o diretório virtual do ECP é criado.

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.