New-OwaVirtualDirectory
Gilt für: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Letztes Änderungsdatum des Themas: 2010-02-25
Das Cmdlet New-OWAVirtualDirectory erstellt auf einem Computer, auf dem Microsoft Exchange Server 2007 ausgeführt wird, auf einer IIS-Website (Internetinformationsdienste) ein neues virtuelles Outlook Web Access-Verzeichnis.
Syntax
New-OwaVirtualDirectory [-Name <String>] [-ApplicationRoot <String>] [-AppPoolId <String>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-ExternalAuthenticationMethods <MultiValuedProperty>] [-ExternalUrl <Uri>] [-InternalUrl <Uri>] [-OwaVersion <Exchange2003or2000 | Exchange2007>] [-Path <String>] [-TemplateInstance <PSObject>] [-VirtualDirectoryType <NotSpecified | Mailboxes | PublicFolders | Exchweb | Exadmin>] [-WebSiteName <String>] [-WhatIf [<SwitchParameter>]]
Detaillierte Beschreibung
Standardmäßig werden bei der Installation von Exchange 2007 die folgenden virtuellen Outlook Web Access-Verzeichnisse auf der Standardwebsite von IIS auf dem lokalen Server erstellt, auf dem Microsoft Exchange ausgeführt wird:
Owa Ein virtuelles Exchange 2007 Outlook Web Access-Verzeichnis.
Exchange Ein virtuelles Outlook Web Access-Legacyverzeichnis, auf das Benutzer zugreifen können, die über Postfächer auf Servern verfügen, auf denen Exchange Server 2003 oder Exchange 2000 Server ausgeführt wird.
Public Ein virtuelles Outlook Web Access-Legacyverzeichnis, das auf die Öffentlichen Ordner auf Servern verweist, auf denen Exchange 2003 oder Exchange 2000 ausgeführt wird.
Exchweb Ein virtuelles Outlook Web Access-Legacyverzeichnis, mit dessen Hilfe Benutzer auf die virtuellen Outlook Web Access-Verzeichnisse zugreifen können. Standardmäßig werden Anforderungen an das virtuelle Verzeichnis exchweb an den Postfachserver des Benutzers gesendet.
Hinweis
Allgemein verwenden Sie das Cmdlet New-OWAVirtualDirectory, wenn spezielle Geschäftsanforderungen bestehen, die zusätzliche virtuelle Verzeichnisse erfordern, z. B. Hosting, oder für Outlook Web Access-Problembehandlungsaufgaben, z. B. das Löschen und Neuerstellen eines virtuellen Outlook Web Access-Verzeichnisses.
Das Cmdlet New-OwaVirtualDirectory muss auf dem Exchange 2007-Server ausgeführt werden, auf dem die Serverfunktion ClientAccess installiert ist und auf dem Sie das neue virtuelle Verzeichnis hosten möchten. An das verwendete Konto muss die Exchange-Serveradministrator-Rolle und die Mitgliedschaft in der lokalen Gruppe Administratoren für den Zielserver delegiert worden sein.
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 |
|---|---|---|---|
ApplicationRoot |
Optional |
System.String |
Dieser Parameter legt den Pfad des virtuellen Verzeichnisses in der Metabase fest. Hinweis Dieser Parameter wurde nicht implementiert. |
AppPoolId |
Optional |
System.String |
Dieser Parameter legt den IIS-Anwendungspool fest, in dem Outlook Web Access ausgeführt wird. Am besten verwenden Sie für diesen Parameter den Standardwert. |
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 dem Active Directory-Verzeichnisdienst abruft. |
ExternalAuthenticationMethods |
Optional |
Microsoft.Exchange.Data.MultiValuedProperty |
Dieser Parameter, eine Einstellung für Eigenschaften der Diensterkennung, legt die Authentifizierungsmethoden fest, die auf dem Server mit Exchange für den Zugang von außerhalb der Firewall unterstützt werden. Hinweis Dieser Parameter wurde nicht implementiert, kann aber mithilfe von Set-OwaVirtualDirectory festgelegt werden. |
ExternalUrl |
Optional |
System.Uri |
Dieser Parameter legt den Hostnamen fest, der verwendet wird, um von außerhalb der Firewall eine Verbindung zum Exchange-Server herzustellen. Die Einstellung ist auch wichtig, wenn SSL (Secure Sockets Layer) verwendet wird. Hinweis Sie können diese Einstellung nur in virtuellen Exchange 2007-Verzeichnissen konfigurieren. Das standardmäßige virtuelle Verzeichnis in Exchange 2007 ist /owa. |
InternalUrl |
Optional |
System.Uri |
Dieser Parameter legt den Hostnamen des Exchange-Serverhosts für die Verbindung von innerhalb der Firewall fest. Die Einstellung ist auch wichtig, wenn SSL verwendet wird. Hinweis Sie können diese Einstellung nur in virtuellen Exchange 2007-Verzeichnissen konfigurieren. Das standardmäßige virtuelle Verzeichnis in Exchange 2007 ist /owa. |
Name |
Optional |
System.String |
Dieser Parameter legt den Namen eines virtuellen Outlook Web Access-Verzeichnisses fest, wenn das virtuelle Outlook Web Access-Verzeichnis sich auf einem Server befindet, auf dem Exchange 2003 oder Exchange 2000 ausgeführt wird. Wenn das virtuelle Outlook Web Access-Verzeichnis sich auf einem Exchange 2007-Server befindet, wird der Parameter ignoriert. |
OWAVersion |
Optional |
Microsoft.Exchange.Data.Directory.SystemConfiguration.OwaVersions |
Dieser Parameter legt fest, ob die Version des virtuellen Outlook Web Access-Verzeichnisses Exchange 2007, Exchange 2003 oder Exchange 2000 lautet. |
Path |
Optional |
System.String |
Dieser Parameter legt den Dateisystempfad des virtuellen Verzeichnisses fest. Dieser Parameter sollte vorsichtig und nur dann verwendet werden, wenn Sie einen anderen Dateisystempfad als den Standardpfad verwenden müssen. |
TemplateInstance |
Optional |
System.Management.Automation.PSObject |
Dieser Parameter gibt an, dass das Cmdlet die Konfiguration eines vorhandenen Objekts verwendet, wenn das Objekt diesem Parameter übergeben wird, um eine identische Kopie des Objekts auf dem lokalen oder einem Zielserver zu erstellen. Hinweis Dieser Parameter wurde nicht implementiert. |
VirtualDirectoryType |
Optional |
Microsoft.Exchange.Data.Directory.SystemConfiguration.VirtualDirectoryTypes |
Dieser Parameter legt fest, ob das virtuelle Outlook Web Access-Verzeichnis auf Postfächer, Öffentliche Ordner oder das Verzeichnis exchweb verweist. Er ist erforderlich, wenn das virtuelle Outlook Web Access-Verzeichnis sich auf einem Exchange 2003- oder Exchange 2000-Server befindet. Wenn das virtuelle Outlook Web Access-Verzeichnis sich auf einem Exchange 2007-Server befindet, wird dieser Parameter ignoriert. |
WebSiteName |
Optional |
System.String |
Dieser Parameter legt den Namen der IIS-Website fest, unter der das virtuelle Outlook Web Access-Verzeichnis erstellt wird. |
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 WhatIf-Parameters 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
In den folgenden Codebeispielen wird eine Reihe neuer virtueller Outlook Web Access-Legacyverzeichnisse mit den Namen exchange, public und exchweb auf einer nicht standardmäßigen IIS-Website mit dem Namen contoso.com auf dem lokalen Servercomputer mit Exchange erstellt.
New-OWAVirtualDirectory -OwaVersion:Exchange2003or2000 -VirtualDirectoryType Mailboxes -Name "exchange" -WebSiteName "Contoso.com"
New-OWAVirtualDirectory -OwaVersion:Exchange2003or2000 -VirtualDirectoryType PublicFolders -Name "public" -WebSiteName "Contoso.com"
New-OWAVirtualDirectory -OwaVersion:Exchange2003or2000 -VirtualDirectoryType Exchweb -Name "exchweb" -WebSiteName "Contoso.com"