Remove-OwaVirtualDirectory
Gilt für: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Letztes Änderungsdatum des Themas: 2007-06-28
Das Cmdlet Remove-OwaVirtualDirectory entfernt virtuelle Outlook Web Access-Verzeichnisse, die sich auf der IIS-Website (Internetinformationsdienste) auf einem Server befinden, der Microsoft Exchange Server 2007 ausführt.
Syntax
Remove-OwaVirtualDirectory -Identity <VirtualDirectoryIdParameter> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-WhatIf [<SwitchParameter>]]
Detaillierte Beschreibung
Zum Ausführen des Cmdlets Remove-OwaVirtualDirectory müssen Sie den Namen des zu entfernenden virtuellen Outlook Web Access-Verzeichnisses angeben.
Die Verwendung des Cmdlets Remove-OwaVirtualDirectory kann in den folgenden Situationen erforderlich werden:
Das Cmdlet Get-OwaVirtualDirectory erkennt ein virtuelles Outlook Web Access-Verzeichnis, das in IIS gelöscht wurde, jedoch nicht in Active Directory gelöscht wird. Diese aufgegebenen virtuellen Outlook Web Access-Verzeichnisobjekte werden als Active Directory-Waisenobjekte bezeichnet. Es wird empfohlen, diese Art von virtuellem Outlook Web Access-Verzeichnis in Active Directory mithilfe des Cmdlets Remove-OwaVirtualDirectory zu entfernen.
Es ist sinnvoll, alle virtuellen Outlook Web Access-Legacyverzeichnisse aus einer einheitlichen Exchange 2007-Organisation zu entfernen. Die virtuellen Outlook Web Access-Legacyverzeichnisse wurden möglicherweise während des Exchange 2007-Setups oder in einer gemischten Exchange-Umgebung manuell erstellt.
Sie führen die Fehlerbehebung für ein Outlook Web Access-Konfigurationsproblem durch, für das das Löschen des vorhandenen virtuellen Outlook Web Access-Verzeichnisses und das anschließende erneute Erstellen des virtuellen Outlook Web Access-Verzeichnisses erforderlich ist.
Wenn Sie die Serverfunktion ClientAccess vom Exchange-Server deinstallieren, werden auch alle virtuellen Outlook Web Access-Verzeichnisse auf dem betreffenden Exchange-Server entfernt.
.gif "Caution") Achtung: |
|---|
| Das Cmdlet Remove-OwaVirtualDirectory entfernt ein virtuelles Outlook Web Access-Verzeichnis oder virtuelle Outlook Web Access-Verzeichnisse permanent. Achten Sie bei der Verwendung des Cmdlets Remove-OwaVirtualDirectory darauf, nicht versehentlich ein virtuelles Outlook Web Access-Standardverzeichnis zu löschen. Es bestehen keine Standardwerte für das Cmdlet Remove-OwaVirtualDirectory. |
Hinweis
Das Cmdlet Remove-OwaVirtualDirectory unterstützt das Confirm-Flag.
Das Cmdlet Remove-OwaVirtualDirectory kann auf jedem beliebigen Server ausgeführt werden, auf dem die Exchange Server-Verwaltungstools installiert sind. An das verwendete Konto muss Folgendes delegiert worden sein: die Exchange-Serveradministrator-Rolle und Mitgliedschaft in der lokalen Gruppe Administratoren für den Zielserver.
Weitere Informationen zu Berechtigungen, zum Delegieren von Rollen und zu den Rechten, die für die Verwaltung von Exchange 2007 erforderlich sind, finden Sie unter Überlegungen zu Berechtigungen.
Parameter
| Parameter | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
Identity |
Erforderlich |
Microsoft.Exchange.Configuration.Tasks.VirtualDirectoryIdParameter |
Dieser Parameter gibt den Namen oder die GUID eines virtuellen Outlook Web Access-Verzeichnisses an. Es wird in dieser Form dargestellt: |
Confirm |
Optional |
System.Management.Automation.SwitchParameter |
Dieser Parameter bewirkt eine Unterbrechung der Befehlsausführung und zwingt den Benutzer, die Aktion des Befehls zu bestätigen, bevor die Verarbeitung fortgesetzt wird. Für den Parameter Confirm muss kein Wert angegeben werden. |
DomainController |
Optional |
Microsoft.Exchange.Data.Fqdn |
Dieser Parameter gibt den vollqualifizierten Domänennamen (Fully Qualified Domain Name, FQDN) des Domänencontrollers an, der Daten aus Active Directory abruft. |
WhatIf |
Optional |
System.Management.Automation.SwitchParameter |
Dieser Parameter weist den Befehl an, die Aktionen zu simulieren, die für das Objekt ausgeführt würden. Durch Verwendung des Parameters WhatIf können Sie eine Vorschau der Änderungen anzeigen, ohne diese Änderungen wirklich übernehmen zu müssen. Für den Parameter WhatIf muss kein Wert angegeben werden. |
Eingabetypen
Rückgabetypen
Fehler
| Fehler | Beschreibung |
|---|---|
|
|
Ausnahmen
| Ausnahmen | Beschreibung |
|---|---|
|
|
Beispiel
Das folgende Codebeispiel entfernt ein angegebenes virtuelles Outlook Web Access-Verzeichnis mit dem Namen "owa", das sich auf der IIS-Standardwebsite auf einem Exchange-Server mit dem Namen "Contoso" befindet.
Remove-OwaVirtualDirectory -identity "Contoso\owa (default web site)"