Share via


New-AutodiscoverVirtualDirectory

 

Aplica-se a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

Tópico modificado em: 2007-08-17

Use o cmdlet New-AutodiscoverVirtualDirectory para criar um novo diretório virtual de Descoberta Automática em um computador que esteja executando o Microsoft Exchange Server 2007 em que a função de servidor Acesso para Cliente esteja instalada. Se sua organização tiver vários domínios de email e cada um deles precisar de sites próprios de Descoberta Automática e do respectivo diretório virtual, use esse cmdlet para criar um novo diretório virtual de Descoberta Automática em um novo site.

Sintaxe

New-AutodiscoverVirtualDirectory [-ApplicationRoot <String>] [-AppPoolId <String>] [-BasicAuthentication <$true | $false>] [-Confirm [<SwitchParameter>]] [-DigestAuthentication <$true | $false>] [-DomainController <Fqdn>] [-ExternalUrl <Uri>] [-InternalUrl <Uri>] [-Path <String>] [-TemplateInstance <PSObject>] [-WebSiteName <String>] [-WhatIf [<SwitchParameter>]] [-WindowsAuthentication <$true | $false>]

Descrição detalhada

Use o cmdlet New-AutodiscoverVirtualDirectory para criar um novo diretório virtual de Descoberta Automática em um servidor de Acesso para Cliente do Exchange 2007. Se sua organização tiver vários domínios de email e cada um deles precisar de sites próprios de Descoberta Automática e do respectivo diretório virtual, use esse cmdlet para criar um novo diretório virtual de Descoberta Automática em um novo site.

Dica

Quando estiver criando um novo diretório virtual de Descoberta Automática, recomendamos que você habilite o SSL (Secure Sockets Layer) no serviço de Descoberta Automática.

Para executar o cmdlet New-AutodiscoverVirtualDirectory, você deve usar uma conta à qual esteja delegada a função Administrador do Exchange e o grupo Administradores local do servidor de destino.

Para obter mais informações sobre permissões, delegação de funções e os direitos necessários para administrar o Exchange 2007, consulte Considerações sobre permissão

Parâmetros

Parâmetro Necessário(s) Tipo Descrição

ApplicationRoot

Opcional

System.String

Esse parâmetro define o caminho de metabase do diretório virtual. Por padrão, esse caminho é o mesmo do site em que o diretório virtual foi criado.

AppPoolId

Opcional

System.String

Esse parâmetro define o pool de programas que podem ser usados com o diretório virtual.

BasicAuthentication

Opcional

System.Boolean

Esse parâmetro especifica se a Autenticação básica está habilitada no diretório virtual de Descoberta Automática.

Confirm

Opcional

System.Management.Automation.SwitchParameter

Esse parâmetro faz com que o comando pause o processamento e exige que você confirme o que o comando fará antes que o processamento continue. Você não precisa especificar um valor com o parâmetro Confirm.

DigestAuthentication

Opcional

System.Boolean

Esse parâmetro especifica se a Autenticação resumida está habilitada no diretório virtual de Descoberta Automática.

DomainController

Opcional

Microsoft.Exchange.Data.Fqdn

Para especificar o nome de domínio totalmente qualificado (FQDN) do controlador de domínio que grava essa alteração de configuração no serviço de diretório do Active Directory, inclua o parâmetro DomainController no cmdlet.

ExternalUrl

Opcional

System.Uri

Esse parâmetro especifica a URL usada para conectar ao diretório virtual de fora do firewall da rede.

InternalUrl

Opcional

System.Uri

Esse parâmetro especifica a URL usada para conectar ao diretório virtual de dentro do firewall da rede.

Path

Opcional

System.String

Esse parâmetro define o diretório que contém os arquivos de sistema do diretório virtual.

TemplateInstance

Opcional

System.Management.Automation.PSObject

Quando um objeto existente for fornecido para esse parâmetro, o cmdlet usará a configuração desse objeto para duplicá-lo em um servidor local ou de destino.

WebSiteName

Opcional

System.String

Esse parâmetro especifica o nome do site do IIS (Serviços de Informações da Internet) no qual o diretório virtual será criado.

WindowsAuthentication

Opcional

System.Boolean

Esse parâmetro especifica se a Autenticação integrada do Windows está habilitada no diretório virtual de Descoberta Automática.

WhatIf

Opcional

System.Management.Automation.SwitchParameter

Este parâmetro instrui o comando a simular as ações que ele executaria no objeto. Ao usar o parâmetro WhatIf, você poderá exibir quais alterações ocorrerão sem precisar aplicar nenhuma dessas alterações. Você não precisa especificar nenhum valor com o parâmetro WhatIf.

Tipos de entrada

Tipos de retorno

Erros

Erro Descrição

 

 

Exceções

Exceções Descrição

 

 

Exemplo

O exemplo de código a seguir cria um novo diretório virtual chamado descoberta automática no site "autodiscover.contoso.com" e exige que o usuário se conecte usando a Autenticação integrada ou a Autenticação resumida sobre SSL do Windows.

New-AutoDiscoverVirtualDirectory -websitename "autodiscover.contoso.com" -WindowsAuthentication $true -DigestAuthentication $true