New-WebServicesVirtualDirectory
Gilt für: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Letztes Änderungsdatum des Themas: 2007-08-20
Mit dem Cmdlet New-WebServicesVirtualDirectory können Sie ein neues virtuelles Verzeichnis mit dem Namen EWS auf dem Computer mit Microsoft Exchange Server 2007 erstellen, auf dem die Serverfunktion ClientAccess installiert ist.
Syntax
New-WebServicesVirtualDirectory [-ApplicationRoot <String>] [-AppPoolId <String>] [-BasicAuthentication <$true | $false>] [-Confirm [<SwitchParameter>]] [-DigestAuthentication <$true | $false>] [-DomainController <Fqdn>] [-ExternalUrl <Uri>] [-InternalNLBBypassUrl <Uri>] [-InternalUrl <Uri>] [-Path <String>] [-TemplateInstance <PSObject>] [-WebSiteName <String>] [-WhatIf [<SwitchParameter>]] [-WindowsAuthentication <$true | $false>]
Detaillierte Beschreibung
Mit dem Cmdlet New-WebServicesVirtualDirectory können Sie ein neues virtuelles Verzeichnis mit dem Namen EWS auf einem Exchange 2007-Clientzugriffsserver erstellen. Sie können mithilfe dieses Cmdlets auch mehrere virtuelle Verzeichnisse erstellen.
Hinweis
Sie können für jede Website nur ein virtuelles Verzeichnis mit dem Namen EWS erstellen.
Damit Sie das Cmdlet New-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 Exchange 2007 erforderlich sind, finden Sie unter Überlegungen zu Berechtigungen.
Parameter
| Parameter | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
ApplicationRoot |
Optional |
System.String |
Dieser Parameter legt den Metabasepfad des virtuellen Verzeichnisses fest. Standardmäßig entspricht dieser Pfad der Website, in der das virtuelle Verzeichnis erstellt wird. |
AppPoolId |
Optional |
System.String |
Dieser Parameter legt den Programmpool fest, der mit dem virtuellen Verzeichnis verwendet werden kann. |
BasicAuthentication |
Optional |
System.Boolean |
Dieser Parameter gibt an, ob die Standardauthentifizierung für das virtuelle Verzeichnis EWS aktiviert ist. |
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 bei seiner Verwendung an, dass für das virtuelle Verzeichnis Digestauthentifizierung verwendet wird. |
DomainController |
Optional |
Microsoft.Exchange.Data.Fqdn |
Um den vollqualifizierten Domänennamen (Fully Qualified Domain Name, FQND) des Domänencontrollers anzugeben, der diese Konfigurationsänderung in den Active Directory-Verzeichnisdienst schreibt, fügen Sie dem Cmdlet den Parameter DomainController hinzu. |
ExternalUrl |
Optional |
System.Uri |
Dieser Parameter gibt den Hostnamen an, der verwendet wird, um von außerhalb des Umkreisnetzwerks eine Verbindung mit dem Exchange-Server herzustellen. |
InternalNLBBypassUrl |
Optional |
System.Uri |
Dieser Parameter gibt den URL des Clientzugriffsservers an, unabhängig davon, ob sich dieser hinter einem NLB-Array (Network Load Balancing, Netzwerklastenausgleich) befindet. Der Parameter InternalUrl wird zwar auf den URL des NLB-Arrays festgelegt, aber der Parameter InternalNLBBypassUrl muss trotzdem auf den URL des Clientzugriffsservers festgelegt werden. Der Grund dafür ist, dass für bestimmte Anrufe über die Exchange-Webdienste Computeraffinität erforderlich ist und die Exchange-Webdienste eingehende Anrufe nach Möglichkeit über einen Proxy an einen geeigneteren Clientzugriffsserver leiten. |
InternalUrl |
Optional |
System.Uri |
Dieser Parameter gibt den zu verwendenden URL an, wenn innerhalb der Netzwerkfirewall auf das virtuelle Verzeichnis zugegriffen wird. |
Path |
Optional |
System.String |
Dieser Parameter legt den Pfad des virtuellen Verzeichnisses in der Metabase fest. |
TemplateInstance |
Optional |
System.Management.Automation.PSObject |
Wenn ein vorhandenes Objekt an diesen Parameter übergeben wird, verwendet der Befehl die Konfiguration dieses Objekts zum Erstellen einer Kopie des Objekts auf einem lokalen oder Zielserver. |
WebSiteName |
Optional |
System.String |
Dieser Parameter gibt den Namen der Website an, auf der das neue virtuelle Verzeichnis erstellt wird. Dieser Parameter darf nicht verwendet werden, wenn ein neues virtuelles Verzeichnis auf der Standardwebsite erstellt wird. |
WindowsAuthentication |
Optional |
System.Boolean |
Verwenden Sie diesen Parameter, um anzugeben, ob die integrierte Windows-Authentifizierung für das neue virtuelle Exchange-Webdiensteverzeichnis zulässig ist. |
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 Parameter WhatIf muss kein Wert angegeben werden. |
Eingabetypen
Rückgabetypen
Fehler
| Fehler | Beschreibung |
|---|---|
|
|
Ausnahmen
| Ausnahmen | Beschreibung |
|---|---|
|
|
Beispiel
Dieses Codebeispiel erstellt ein neues virtuelles Verzeichnis namens "contoso" mit dem externen URL "https://www.contoso.com/webservices.aspx".
New-WebServicesVirtualDirectory -WebsiteName "www.contoso.com" -ExternalUrl "https://www.contoso.com/webservices.aspx"