Set-UMVirtualDirectory
Aplica-se a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Tópico modificado em: 2008-11-10
Use o cmdlet Set-UMVirtualDirectory para modificar um diretório virtual de Unificação de Mensagens do Exchange existente em um computador em que a função de servidor Acesso para Cliente esteja instalada.
Sintaxe
Set-UMVirtualDirectory -Identity <VirtualDirectoryIdParameter> [-BasicAuthentication <$true | $false>] [-Confirm [<SwitchParameter>]] [-DigestAuthentication <$true | $false>] [-DomainController <Fqdn>] [-ExternalUrl <Uri>] [-InternalUrl <Uri>] [-WhatIf [<SwitchParameter>]] [-WindowsAuthentication <$true | $false>]
Set-UMVirtualDirectory [-BasicAuthentication <$true | $false>] [-Confirm [<SwitchParameter>]] [-DigestAuthentication <$true | $false>] [-DomainController <Fqdn>] [-ExternalUrl <Uri>] [-Instance <ADUMVirtualDirectory>] [-InternalUrl <Uri>] [-WhatIf [<SwitchParameter>]] [-WindowsAuthentication <$true | $false>]
Descrição detalhada
O cmdlet Set-UMVirtualDirectory permite modificar um diretório virtual existente de Serviços da Web do Exchange em um servidor de Acesso para Cliente do Exchange 2007.
Para executar o cmdlet Set-UMVirtualDirectory, você deve usar uma conta à qual esteja delegada a função de 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 | Tipo | Descrição |
|---|---|---|---|
Identity |
Necessário |
Microsoft.Exchange.Configuration.Tasks.VirtualDirectoryIdParameter |
Esse parâmetro especifica o nome do diretório virtual. Também é possível 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 da Web do Exchange. Esse parâmetro pode ser usado com o parâmetro FormsAuthentication ou com os parâmetros DigestAuthentication e WindowsAuthentication. |
Confirm |
Opcional |
System.Management.Automation.SwitchParameter |
Esse parâmetro faz com que o comando pause o processamento. O administrador deve confirmar o que o comando fará antes que o processamento continue. O valor padrão é |
DigestAuthentication |
Opcional |
System.Boolean |
Esse parâmetro especifica se a Autenticação resumida está habilitada no diretório virtual. |
DomainController |
Opcional |
Microsoft.Exchange.Data.Fqdn |
Esse parâmetro especifica o FQDN (nome de domínio totalmente qualificado) 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 |
Esse parâmetro especifica o nome do host que será usado para conectar ao servidor de Acesso para Cliente de fora do firewall. Essa configuração também é importante quando SSL (Secure Sockets Layer) é usado. |
Instance |
Opcional |
Microsoft.Exchange.Data.Directory.SystemConfiguration.ADUMVirtualDirectory |
Esse parâmetro especifica se um objeto inteiro deve ser passado ao cmdlet para ser processado. Ele é usado principalmente em scripts onde um objeto completo deve ser passado para o cmdlet. |
InternalUrl |
Opcional |
System.Uri |
Esse parâmetro especifica o nome do host do servidor de Acesso para Cliente para conexões de dentro do firewall. Essa configuração é importante quando SSL é usado. |
WindowsAuthentication |
Opcional |
System.Boolean |
Esse parâmetro especifica se a autenticação Integrada do Windows é permitida no diretório virtual de Unificação de Mensagens. |
WhatIf |
Opcional |
System.Management.Automation.SwitchParameter |
Esse parâmetro faz com que o comando simule as ações que ele executaria no objeto. Um administrador pode usar o parâmetro WhatIf para visualizar quais alterações ocorreriam sem precisar aplicar nenhuma dessas alterações. O valor padrão é |
Tipos de entrada
Tipos de retorno
Erros
| Erro | Descrição |
|---|---|
|
|
Exceções
| Exceções | Descrição |
|---|---|
|
|
Exemplo
O primeiro exemplo de código define o método de autenticação como Autenticação resumida para o diretório virtual de Unificação de Mensagens no servidor chamado UMserver1. Esse exemplo de código também define as URLs externa e interna desse diretório virtual.
O segundo exemplo de código usa um caractere curinga em vez de "site padrão".
Set-UMVirtualDirectory -Identity UMServer1\UnifiedMessaging -ExternalUrl https://www.contoso.com/UnifiedMessaging/service.asmx -ExternalAuthenticationMethods Digest -InternalUrl https://contoso.internal.com/UnifiedMessaging/service.asmx
Set-UMVirtualDirectory -Identity UMServer1\UnifiedMessaging* -ExternalUrl https://www.contoso.com/UnifiedMessaging/service.asmx