Partilhar via

Remove-OwaVirtualDirectory (RTM)

  • Artigo

 

Aplica-se a: Exchange Server 2007

Tópico modificado em: 2007-06-11

O cmdlet Remove-OwaVirtualDirectory remove os diretórios virtuais do Outlook Web Access localizados no site do IIS (Serviços de Informações da Internet) em um servidor que esteja executando o Microsoft Exchange Server 2007.

Sintaxe

Remove-OwaVirtualDirectory -Identity <VirtualDirectoryIdParameter> [-DomainController <Fqdn>]

Descrição detalhada

Para executar o cmdlet Remove-OwaVirtualDirectory, você deve especificar o nome do diretório virtual do Outlook Web Access que você deseja remover.

Você poderá usar o cmdlet Remove-OwaVirtualDirectory nas seguintes situações:

  • O cmdlet Get-OwaVirtualDirectory detecta um diretório virtual do Outlook Web Access que foi excluído do IIS, mas não foi excluído do Active Directory. Esses objetos abandonados do diretório virtual do Outlook Web Access são conhecidos como órfãos do Active Directory. É recomendável que você remova esse tipo de diretório virtual do Outlook Web Access no Active Directory usando o cmdlet Remove-OwaVirtualDirectory.

  • Você deseja remover todos os diretórios virtuais herdados do Outlook Web Access de sua organização nativa do Exchange 2007. Os diretórios virtuais herdados do Outlook Web Access podem ter sido criados durante a Instalação do Exchange 2007 ou podem ter sido criados manualmente em um ambiente misto do Exchange.

  • Você está solucionando problemas de configuração do Outlook Web Access que exigem que você exclua o diretório virtual do Outlook Web Access existente e, em seguida, recrie o diretório virtual do Outlook Web Access.

  • Se você desinstalar a função de servidor Acesso para Cliente do servidor Exchange, todos os diretórios virtuais do Outlook Web Access desse servidor Exchange também serão removidos.

Aviso

O cmdlet Remove-OwaVirtualDirectory remove permanentemente um diretório ou vários diretórios virtuais do Outlook Web Access. Quando você usar o cmdlet Remove-OwaVirtualDirectory, assegure-se de não excluir acidentalmente um diretório virtual padrão do Outlook Web Access. Não há valores padrão para o cmdlet Remove-OwaVirtualDirectory.

Dica

O cmdlet Remove-OwaVirtualDirectory oferece suporte ao sinalizador Confirm.

O cmdlet Remove-OwaVirtualDirectory pode ser executado em qualquer servidor em que as ferramentas de administração do Exchange Server estejam instaladas. Você deve usar uma conta para a qual estejam delegadas as seguintes funções:

  • 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

Esse parâmetro especifica o nome ou a GUID de um diretório virtual do Outlook Web Access. Ele é representado como: ServerName\VirtualDirectoryName (WebsiteName).

DomainController

Opcional

Microsoft.Exchange.Data.Fqdn

Para especificar o 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 comando.

Tipos de entrada

Tipos de retorno

Erros

Erro Descrição

 

 

Exceções

Exceções Descrição

 

 

Exemplo

O exemplo de código a seguir remove um diretório virtual especificado do Outlook Web Access chamado "owa", localizado no site padrão do IIS em um servidor Exchange chamado "Contoso".

Remove-OwaVirtualDirectory -identity "Contoso\owa (default web site)"