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"