Set-WebServicesVirtualDirectory
Gilt für: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Letztes Änderungsdatum des Themas: 2011-06-21
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>] [-Confirm [<SwitchParameter>]] [-DigestAuthentication <$true | $false>] [-DomainController <Fqdn>] [-ExternalUrl <Uri>] [-InternalNLBBypassUrl <Uri>] [-InternalUrl <Uri>] [-WhatIf [<SwitchParameter>]] [-WindowsAuthentication <$true | $false>]
Set-WebServicesVirtualDirectory [-BasicAuthentication <$true | $false>] [-Confirm [<SwitchParameter>]] [-DigestAuthentication <$true | $false>] [-DomainController <Fqdn>] [-ExternalUrl <Uri>] [-Instance <ADWebServicesVirtualDirectory>] [-InternalNLBBypassUrl <Uri>] [-InternalUrl <Uri>] [-WhatIf [<SwitchParameter>]] [-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 zu verwenden.
Damit Sie das Cmdlet Set-WebServicesVirtualDirectory 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 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. Sie können anstelle der Standardwebsite auch ein Platzhalterzeichen angeben. |
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. |
Confirm |
Optional |
System.Management.Automation.SwitchParameter |
Der Confirm-Parameter bewirkt eine Unterbrechung der Befehlsausführung und zwingt Sie, die Aktion des Befehls zu bestätigen, bevor die Verarbeitung fortgesetzt wird. Für den Parameter Confirm muss kein Wert angegeben werden. |
DigestAuthentication |
Optional |
System.Boolean |
Dieser Parameter gibt an, ob die Digestauthentifizierung für das virtuelle Verzeichnis aktiviert ist. |
DomainController |
Optional |
Microsoft.Exchange.Data.Fqdn |
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 vollständigen Objekts an das zu verarbeitende Cmdlet. |
InternalNLBBypassUrl |
Optional |
System.Uri |
Dieser Parameter gibt den URL des Clientzugriffsservers selbst dann an, wenn sich der Clientzugriffsserver hinter einem NLB (Network Load Balancer) befindet. |
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. |
WhatIf |
Optional |
System.Management.Automation.SwitchParameter |
Der Parameter WhatIf weist den Befehl an, die für das Objekt ausgeführten Aktionen lediglich zu simulieren. Durch Verwendung des WhatIf-Parameters können Sie eine Vorschau der Änderungen anzeigen, ohne diese Änderungen wirklich übernehmen zu müssen. Für den WhatIf-Parameter muss kein Wert angegeben werden. |
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. In diesem Codebeispiel werden auch 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.asmx - BasicAuthentication $true InternalUrl https://contoso.internal.com/EWS/webservices.aspx
Set-WebServicesVirtualDirectory -Identity Contoso\EWS* -ExternalUrl https://www.contoso.com/ews/exchange.asmx