Remove-OwaVirtualDirectory

 

Применимо к: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

Последнее изменение раздела: 2007-06-28

Командлет Remove-OwaVirtualDirectory удаляет виртуальные каталоги Outlook Web Access, размещенные на веб-узле IIS на сервере, на котором работает Microsoft Exchange Server 2007.

Синтаксис

Remove-OwaVirtualDirectory -Identity <VirtualDirectoryIdParameter> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-WhatIf [<SwitchParameter>]]

Подробное описание

Чтобы запустить командлет Remove-OwaVirtualDirectory , необходимо указать имя виртуального каталога Outlook Web Access, который нужно удалить.

Командлет Remove-OwaVirtualDirectory может понадобиться в следующих ситуациях:

  • Командлет Get-OwaVirtualDirectory определяет виртуальный каталог Outlook Web Access, удаленный в IIS, но не удаленный в Active Directory. Эти оставшиеся неудаленными объекты виртуальных каталогов Outlook Web Access также называются «сиротами» Active Directory. Рекомендуется удалить виртуальные каталоги этого типа Outlook Web Access в Active Directory с помощью командлета Remove-OwaVirtualDirectory.

  • Необходимо удалить все устаревшие виртуальные каталоги Outlook Web Access из основной организации Exchange 2007. Устаревшие виртуальные каталоги Outlook Web Access могли быть созданы во время установки Exchange 2007 или созданы вручную в смешанной среде Exchange.

  • Устраняются неполадки конфигурации Outlook Web Access, требующие удалить существующий виртуальный каталог Outlook Web Access, а затем повторно создается виртуальный каталог Outlook Web Access.

  • Если удаляется роль сервера клиентского доступа с сервера Exchange, все виртуальные каталоги Outlook Web Access на этом сервере Exchange также удаляются.

CautionВнимание!
Командлет Remove-OwaVirtualDirectory окончательно удаляет виртуальный каталог или каталоги Outlook Web Access. При использовании командлета Remove-OwaVirtualDirectory убедитесь, что случайно не был удален виртуальный каталог Outlook Web Access. Для командлета Remove-OwaVirtualDirectory не существует значений по умолчанию.
noteПримечание.
Командлет Remove-OwaVirtualDirectory поддерживает флаг Confirm.

Командлет Remove-OwaVirtualDirectory может быть запущен на любом сервере, на котором установлены средства администрирования Exchange Server. Используемой учетной записи необходимо делегировать роль администратора сервера Exchange и членство в локальной группе администраторов целевого сервера.

Дополнительные сведения о разрешениях, делегировании ролей и правах, необходимых для администрирования Exchange 2007, см. в разделе Вопросы, связанные с разрешениями.

Параметры

Параметр Обязательный Тип Описание

Identity

Обязательный

Microsoft.Exchange.Configuration.Tasks.VirtualDirectoryIdParameter

Этот параметр указывает имя или идентификатор GUID виртуального каталога Outlook Web Access. Он представлен как: ServerName\VirtualDirectoryName (WebsiteName).

Confirm

Необязательный

System.Management.Automation.SwitchParameter

Этот параметр используется для приостановки команды и требует подтверждения выполняемого ею действия. Указывать значение параметра Confirm не требуется.

DomainController

Необязательный

Microsoft.Exchange.Data.Fqdn

Этот параметр определяет полное доменное имя контроллера домена, который извлекает данные из Active Directory.

WhatIf

Необязательный

System.Management.Automation.SwitchParameter

Этот параметр заставляет команду имитировать действия, которые она будет выполнять над объектом. Параметр WhatIf позволяет узнать, какие изменения произойдут, не применяя их. Указывать значение параметра WhatIf не требуется.

Типы входных данных

Типы возвращаемых данных

Ошибки

Ошибка Описание

 

 

Исключения

Исключения Описание

 

 

Пример

В следующем примере кода удаляется указанный виртуальный каталог Outlook Web Access с именем «owa», размещенный на веб-узле IIS на сервере Exchange с именем «Contoso».

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