Set-WebServicesVirtualDirectory (RTM)
Gilt für: Exchange Server 2007
Letztes Änderungsdatum des Themas: 2007-06-11
Mit dem Cmdlet Set-WebServicesVirtualDirectory können Sie ein vorhandenes virtuelles Verzeichnis der Exchange-Webdienste auf einem Computer mit Exchange 2007 erstellen, auf dem die Serverfunktion ClientAccess installiert ist.
Syntax
Set-WebServicesVirtualDirectory -Identity <VirtualDirectoryIdParameter> [-BasicAuthentication <$true | $false>] [-DigestAuthentication <$true | $false>] [-DomainController <Fqdn>] [-ExternalUrl <Url>] [-InternalUrl <Url>] [-WindowsAuthentication <$true | $false>]
Detaillierte Beschreibung
Mit dem Cmdlet Set-WebServicesVirtualDirectory können Sie ein vorhandenes virtuelles Verzeichnis der Exchange-Webdienste auf einem Computer mit Exchange 2007 ändern, auf dem die Serverfunktion ClientAccess installiert ist.
Hinweis
Wenn Sie über eine Reihe von Clientzugriffsservern mit Netzwerklastenausgleich verfügen, dann müssen Sie beim Ausführen des Cmdlets nicht die Namen der einzelnen Server angeben. Es ist ausreichend, den Namen eines der Server mit Netzwerklastenausgleich verwenden.
Damit Sie das Cmdlet Set-WebServicesVirtualDirectory ausführen können, muss Folgendes an das verwendete Konto delegiert worden sein:
- die Rolle Exchange-Serveradministrator und die 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 Microsoft Exchange Server 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 des virtuellen Verzeichnisses an. Anstelle der Standardwebsite kann ebenfalls ein Platzhalterzeichen angegeben werden. |
BasicAuthentication |
Optional |
System.Boolean |
Dieser Parameter gibt an, ob die Standardauthentifizierung für das virtuelle Verzeichnis der Exchange-Webdienste aktiviert ist. Dieser Parameter kann zusammen mit FormsAuthentication oder mit DigestAuthentication und WindowsAuthentication verwendet werden. |
DigestAuthentication |
Optional |
System.Boolean |
Dieser Parameter gibt an, ob die Digestauthentifizierung für das virtuelle Verzeichnis aktiviert ist. |
DomainController |
Optional |
System.String |
Um den vollqualifizierten Domänennamen des Domänencontrollers anzugeben, der Daten aus dem Verzeichnisdienst Active Directory abruft, fügen Sie dem Cmdlet den Parameter DomainController hinzu. |
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. |
Instance |
Optional |
Microsoft.Exchange.Data.Directory.SystemConfiguration.ADWebServicesVirtualDirectory |
Der Parameter Instance ermöglicht das Übergeben eines gesamten Objekts an das zu verarbeitende Cmdlet. |
InternalUrl |
Optional |
System.Uri |
Dieser Parameter legt den Hostnamen des Exchange-Servers für die Verbindung von innerhalb der Firewall fest. Die Einstellung ist auch wichtig, wenn SSL verwendet wird. |
WindowsAuthentication |
Optional |
System.Boolean |
Dieser Parameter gibt an, ob die integrierte Windows-Authentifizierung für das virtuelle Verzeichnis der Exchange-Webdienste zulässig ist. |
Eingabetypen
Rückgabetypen
Fehler
| Fehler | Beschreibung |
|---|---|
|
|
Ausnahmen
| Ausnahmen | Beschreibung |
|---|---|
|
|
Beispiel
Im folgenden Beispiel wird für die Authentifizierungsmethode die Standardauthentifizierung für das virtuelle Verzeichnis mit dem Namen EWS auf dem Server Contoso festgelegt. Darüber hinaus werden die externen und internen URLs für dieses virtuelle Verzeichnis festgelegt.
Im zweiten Codebeispiel wird anstelle der Standardwebsite ein Platzhalterzeichen verwendet.
Set-WebServicesVirtualDirectory -Identity Contoso\EWS(default web site)-ExternalUrl https://www.contoso.com/EWS/exchange.aspx -ExternalAuthenticationMethods Basic -InternalUrl https://contoso.internal.com/EWS/webservices.aspx
Set-WebServicesVirtualDirectory -Identity Contoso\EWS* -ExternalUrl https://www.contoso.com/ews/exchange.aspx