Set-UMVirtualDirectory (RTM)

 

Aplica-se a: Exchange Server 2007

Tópico modificado em: 2008-05-14

O cmdlet Set-UMVirtualDirectory permite modificar um diretório virtual existente do Exchange em um computador do Exchange 2007 em que a função de servidor Acesso para Cliente esteja instalada.

Sintaxe

Set-UMVirtualDirectory -Identity <VirtualDirectoryIdParameter> [-BasicAuthentication <$true | $false>] [-DigestAuthentication <$true | $false>] [-DomainController <Fqdn>] [-ExternalUrl <Uri>] [-InternalUrl <Uri>] [-WindowsAuthentication <$true | $false>]

Set-UMVirtualDirectory [-BasicAuthentication <$true | $false>] [-DigestAuthentication <$true | $false>] [-DomainController <Fqdn>] [-ExternalUrl <Uri>] [-Instance <ADUMVirtualDirectory>] [-InternalUrl <Uri>] [-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 delegado o seguinte:

• Função de Administrador do Exchange Server e grupo Administradores local para o 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 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	Use esse parâmetro para especificar o nome do diretório virtual. Também é possível especificar um caractere curinga em vez do site padrão.
BasicAuthentication	Opcional	System.Boolean	Use esse parâmetro para especificar se a Autenticação básica está habilitada no diretório virtual de Serviços da Web do Exchange. Esse parâmetro pode ser usado com FormsAuthentication ou com DigestAuthentication e WindowsAuthentication.
DigestAuthentication	Opcional	System.Boolean	Use esse parâmetro para especificar se a Autenticação resumida está habilitada no diretório virtual.
DomainController	Opcional	Microsoft.Exchange.Data.Fqdn	Use esse parâmetro para especificar o nome de domínio completo (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	Use esse parâmetro para especificar 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	Use esse parâmetro para passar um objeto inteiro para o cmdlet, para ser processado. Ele é usado principalmente em scripts onde um objeto completo deve ser passado para o cmdlet.
InternalUrl	Opcional	System.Uri	Use esse parâmetro para especificar o nome do host do servidor de Acesso para Cliente para conexões de dentro do firewall. Essa configuração também é importante quando SSL é usado.
WindowsAuthentication	Opcional	System.Boolean	Use esse parâmetro para especificar se a Autenticação integrada do Windows é permitida no diretório virtual de Unificação de Mensagens.

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 chamado UnifiedMessaging no servidor chamado UMserver1. Este 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