Set-WebServicesVirtualDirectory
Aplica-se a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Tópico modificado em: 2011-06-21
O cmdlet Set-WebServicesVirtualDirectory permite modificar um diretório virtual de Serviços Web do Exchange em um computador do Exchange 2007 que tenha uma função de servidor de Acesso para Cliente instalada.
Sintaxe
Set-WebServicesVirtualDirectory -Identity <VirtualDirectoryIdParameter> [-BasicAuthentication <$true | $false>] [-Confirm [<SwitchParameter>]] [-DigestAuthentication <$true | $false>] [-DomainController <Fqdn>] [-ExternalUrl <Uri>] [-InternalNLBBypassUrl <Uri>] [-InternalUrl <Uri>] [-WhatIf [<SwitchParameter>]] [-WindowsAuthentication <$true | $false>]
Set-WebServicesVirtualDirectory [-BasicAuthentication <$true | $false>] [-Confirm [<SwitchParameter>]] [-DigestAuthentication <$true | $false>] [-DomainController <Fqdn>] [-ExternalUrl <Uri>] [-Instance <ADWebServicesVirtualDirectory>] [-InternalNLBBypassUrl <Uri>] [-InternalUrl <Uri>] [-WhatIf [<SwitchParameter>]] [-WindowsAuthentication <$true | $false>]
Descrição detalhada
O cmdlet Set-WebServicesVirtualDirectory permite modificar um diretório virtual existente de Serviços Web do Exchange em um servidor de Acesso para Cliente do Exchange 2007.
Dica
Se você tiver um conjunto de servidores de Acesso para Cliente com carga equilibrada, não precisará especificar o nome de cada servidor ao executar o cmdlet. É suficiente usar somente o nome de um dos servidores de carga equilibrada da rede.
Para executar o cmdlet Set-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 Microsoft Exchange Server 2007, consulte Considerações sobre permissão.
Parâmetros
| Parâmetro | Necessário | Tipo | Descrição |
|---|---|---|---|
Identity |
Necessário |
Microsoft.Exchange.Configuration.Tasks.VirtualDirectoryIdParameter |
Este parâmetro especifica o nome do diretório virtual. Você pode também especificar um caractere curinga em vez do site Padrão. |
BasicAuthentication |
Opcional |
System.Boolean |
Esse parâmetro especifica se a Autenticação básica está habilitada no diretório virtual dos Serviços Web do Exchange. Esse parâmetro pode ser usado com FormsAuthentication ou com DigestAuthentication e WindowsAuthentication. |
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 |
Este parâmetro especifica se a Autenticação resumida está habilitada 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 recupera dados do serviço de diretório do Active Directory, inclua o parâmetro DomainController no cmdlet. |
ExternalUrl |
Opcional |
System.Uri |
Este parâmetro especifica o nome do host que será usado para conectar ao servidor Exchange de fora do firewall. Esta configuração também é importante quando SSL (Secure Sockets Layer) é usado. |
Instance |
Opcional |
Microsoft.Exchange.Data.Directory.SystemConfiguration.ADWebServicesVirtualDirectory |
O parâmetro Instance permite que você passe um objeto inteiro para o cmdlet para ser processado. |
InternalNLBBypassUrl |
Opcional |
System.Uri |
Esse parâmetro especifica a URL do servidor de Acesso para Cliente, mesmo que o servidor de Acesso para Cliente esteja atrás de um NLB (network load balancer). |
InternalUrl |
Opcional |
System.Uri |
Este parâmetro especifica o nome do host do servidor Exchange para conexão dentro do firewall. Esta configuração também é importante quando SSL é usado. |
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 um valor com o parâmetro WhatIf. |
WindowsAuthentication |
Opcional |
System.Boolean |
Esse parâmetro especifica se a Autenticação Integrada do Windows é permitida no diretório virtual dos Serviços Web do Exchange. |
Tipos de entrada
Tipos de retorno
Erros
| Erro | Descrição |
|---|---|
|
|
Exceções
| Exceções | Descrição |
|---|---|
|
|
Exemplo
O exemplo de código a seguir define o método de autenticação para Autenticação básica para o diretório virtual chamado "EWS" no servidor chamado "Contoso". Esse exemplo de código também define as URLs externas e internas para esse diretório virtual.
O segundo exemplo de código usa um caractere curinga em vez de "site padrão".
Set-WebServicesVirtualDirectory -Identity Contoso\EWS(default web site)-ExternalUrl https://www.contoso.com/EWS/exchange.asmx - BasicAuthentication $true InternalUrl https://contoso.internal.com/EWS/webservices.aspx
Set-WebServicesVirtualDirectory -Identity Contoso\EWS* -ExternalUrl https://www.contoso.com/ews/exchange.asmx