New-OwaVirtualDirectory (RTM)
Gilt für: Exchange Server 2007
Letztes Änderungsdatum des Themas: 2007-11-15
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>] [-DomainController <Fqdn>] [-ExternalAuthenticationMethods <MultiValuedProperty>] [-ExternalUrl <Uri>] [-InternalUrl <Uri>] [-OwaVersion <Exchange2003or2000 | Exchange2007>] [-Path <String>] [-TemplateInstance <PSObject>] [-VirtualDirectoryType <NotSpecified | Mailboxes | PublicFolders | Exchweb | Exadmin>] [-WebSiteName <String>]
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 Exchange-Server erstellt:
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 Exchange Server 2003- oder Exchange 2000 Server-Servern verfügen.
Public Ein virtuelles Outlook Web Access-Legacyverzeichnis, das auf die Öffentlichen Ordner auf Exchange Server 2003- oder Exchange 2000 Server-Servern verweist.
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. Damit Sie das Cmdlet New-OwaVirtualDirectory ausführen können, muss dem verwendeten Konto die Rolle Exchange-Serveradministrator zugewiesen worden sein, und es muss der lokalen Gruppe Administratoren für den Zielserver angehören.
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. |
DomainController |
Optional |
Microsoft.Exchange.Data.Fqdn |
Um den vollqualifizierten Domänennamen (Fully Qualified Domain Name, FQDN) des Domänencontrollers anzugeben, der Daten aus dem Active Directory-Verzeichnisdienst abruft, fügen Sie dem Befehl den Parameter DomainController hinzu. |
ExternalAuthenticationMethods |
Optional |
Microsoft.Exchange.Data.MultiValuedProperty |
Der Parameter ExternalAuthenticationMethods, 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 (RTM) 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 für virtuelle Exchange 2007-Verzeichnisse konfigurieren. Das virtuelle Exchange 2007-Standardverzeichnis 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 für virtuelle Exchange 2007-Verzeichnisse konfigurieren. Das virtuelle Exchange 2007-Standardverzeichnis 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 Server 2003 oder Exchange 2000 Server 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 ein anderer Dateisystempfad als der Standardpfad erforderlich ist. |
TemplateInstance |
Optional |
System.Management.Automation.PSObject |
Wenn ein vorhandenes Objekt an diesen Parameter übergeben wird, verwendet der Befehl die Konfiguration des Objekts zum Erstellen einer identischen Kopie des Objekts auf einem lokalen oder Zielserver. 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. |
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 Exchange-Server 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"