Compartilhar via

Remove-OwaVirtualDirectory

  • Artigo

 

Aplica-se a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

Tópico modificado em: 2007-06-28

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> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-WhatIf [<SwitchParameter>]]

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 é excluído do IIS, mas não do serviço de diretório 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 do 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 à qual esteja delegada a função Administrador de Servidor do Exchange e a associação no 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

Identity

Necessário(s)

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).

Confirm

Opcional

System.Management.Automation.SwitchParameter

Esse parâmetro 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.

DomainController

Opcional

Microsoft.Exchange.Data.Fqdn

Este parâmetro especifica o FQDN (nome de domínio totalmente qualificado) do controlador de domínio que recupera dados do Active Directory.

WhatIf

Opcional

System.Management.Automation.SwitchParameter

Este parâmetro instrui o comando a simular as ações que ele executaria 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.

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)"