Compartilhar via


New-WebServicesVirtualDirectory

 

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

Tópico modificado em: 2007-08-20

O cmdlet New-WebServicesVirtualDirectory permite que você crie um novo diretório virtual denominado EWS no computador que estiver executando o Microsoft Exchange Server 2007 com a função de servidor Acesso para Cliente instalada.

Sintaxe

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

Descrição detalhada

O cmdlet New-WebServicesVirtualDirectory permite que você crie um novo diretório virtual denomnado EWS no servidor de Acesso para Cliente do Exchange 2007. Você pode criar vários diretórios virtuais com esse cmdlet.

Dica

Só é possível criar um diretório virtual EWS por site da Web.

Para executar o cmdlet New-WebServicesVirtualDirectory, você deve usar uma conta à qual esteja delegada a função Administrador do Exchange Server e a associação ao 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 EWS.

Confirm

Opcional

System.Management.Automation.SwitchParameter

O parâmetro Confirm 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, quando usado, especifica o uso da autenticação resumida no diretório virtual.

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 o nome do host que será usado para conectar ao servidor do Exchange de fora da rede de perímetro.

InternalNLBBypassUrl

Opcional

System.Uri

Este parâmetro especifica a URL de servidor de Acesso para Cliente, independentemente de ele estar atrás de uma matriz NLB (Equilíbro de Carga de Rede). Apesar de o parâmetro InternalUrl estar definido como a URL do NLB, o parâmetro InternalNLBBypassUrl sempre deve ser definido como a URL do servidor de Acesso para Cliente. Isto ocorre porque algumas chamadas de Serviços da Web do Exchange Services exigem afinidade de máquina e os Serviços da Web do Exchange efetuarão um proxy das chamadas recebidas para um servidor de Acesso para Cliente mais adequado sempre que possível.

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 caminho do diretório virtual na metabase.

TemplateInstance

Opcional

System.Management.Automation.PSObject

Quando um objeto existente for fornecido para esse parâmetro, o comando usará a configuração desse objeto para criar uma cópia do objeto em um servidor local ou de destino.

WebSiteName

Opcional

System.String

Esse parâmetro especifica o nome do site em que o novo diretório virtual será criado. Esse parâmetro não deve ser usado quando você estiver criando um novo diretório virtual no site padrão.

WindowsAuthentication

Opcional

System.Boolean

Use esse parâmetro para especificar se a autenticação integrada do Windows é permitida no novo diretório virtual dos Serviços da Web do Exchange.

WhatIf

Opcional

System.Management.Automation.SwitchParameter

O parâmetro WhatIf instrui o comando a simular as ações que ele executará 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

Este exemplo de código cria um novo diretório virtual chamado "contoso" com a URL externa definida como "https://www.contoso.com/webservices.aspx".

New-WebServicesVirtualDirectory -WebsiteName "www.contoso.com" -ExternalUrl "https://www.contoso.com/webservices.aspx"