New-ActiveSyncVirtualDirectory (RTM)
Gilt für: Exchange Server 2007
Letztes Änderungsdatum des Themas: 2007-06-11
Mit dem Befehl New-ActiveSyncVirtualDirectory können Sie ein neues virtuelles Microsoft Exchange ActiveSync-Verzeichnis auf Ihren angegebenen Websites erstellen.
Syntax
New-ActiveSyncVirtualDirectory [-ApplicationRoot <String>] [-AppPoolId <String>] [-DomainController <Fqdn>] [-ExternalAuthenticationMethods <MultiValuedProperty>] [-ExternalUrl <Uri>] [-InternalAuthenticationMethods <MultiValuedProperty>] [-InternalUrl <Uri>] [-Path <String>] [-Server <ServerIdParameter>] [-TemplateInstance <PSObject>] [-WebSiteName <String>]
Detaillierte Beschreibung
Mit dem Befehl New-ActiveSyncVirtualDirectory wird eine neues virtuelles Exchange ActiveSync-Verzeichnis auf dem angegebenen Server unter der angegebenen Website erstellt. Das virtuelle Exchange ActiveSync-Verzeichnis hat den Namen Microsoft-ActiveSync-Server. Jede Exchange ActiveSync-Website kann nur ein virtuelles Exchange ActiveSync-Verzeichnis enthalten.
Damit Sie das Cmdlet New-ActiveSyncVirtualDirectory 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 Exchange Server 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. |
DomainController |
Optional |
Microsoft.Exchange.Data.Fqdn |
Um den vollqualifizierten Domänennamen (Fully Qualified Domain Name, FQDN) des Domänencontrollers anzugeben, der diese Konfigurationsänderung in Active Directory schreibt, fügen Sie dem Befehl den Parameter DomainController hinzu. |
ExternalAuthenticationMethods |
Optional |
Microsoft.Exchange.Data.MultiValuedProperty |
Dieser Parameter gibt die vom Server unterstützten Authentifizierungsmethoden an, wenn außerhalb der Netzwerkfirewall auf das virtuelle Verzeichnis zugegriffen wird. Wenn dieser Parameter nicht festgelegt ist, können alle Authentifizierungsmethoden verwendet werden. |
ExternalUrl |
Optional |
System.Uri |
Dieser Parameter gibt den URL (Uniform Resource Locator) an, um außerhalb der Netzwerkfirewall eine Verbindung zum virtuellen Verzeichnis herzustellen. |
InternalAuthenticationMethods |
Optional |
Microsoft.Exchange.Data.MultiValuedProperty |
Dieser Parameter gibt die vom Server unterstützten Authentifizierungsmethoden an, wenn innerhalb der Netzwerkfirewall auf das virtuelle Verzeichnis zugegriffen wird. Wenn dieser Parameter nicht festgelegt ist, können alle Authentifizierungsmethoden verwendet werden. |
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 das Verzeichnis fest, das die Systemdateien des virtuellen Verzeichnisses enthält. |
Server |
Optional |
Microsoft.Exchange.Configuration.Tasks.ServerIdParameter |
Dieser Parameter legt den Server fest, auf dem das virtuelle Exchange ActiveSync-Verzeichnis erstellt wird. |
TemplateInstance |
Optional |
System.Management.Automation.PSObject |
Wenn ein vorhandenes Objekt an diesen Parameter übergeben wird, verwendet der Befehl die Konfiguration des Objekts zum Erstellen eines exakten Duplikats des Objekts auf einem lokalen oder Zielserver. |
WebSiteName |
Optional |
System.String |
Dieser Parameter legt den Namen der Exchange ActiveSync-Website fest, auf der das neue virtuelle Verzeichnis erstellt wird. |
Eingabetypen
Rückgabetypen
Fehler
| Fehler | Beschreibung |
|---|---|
Ausnahmen
| Ausnahmen | Beschreibung |
|---|---|
Beispiel
Mit dem folgenden Codebeispiel wird das neue virtuelle Verzeichnis namens "Contoso" auf dem Server erstellt.
New-ActiveSyncVirtualDirectory -Server "Contoso" -WebSiteName "Contoso/Default Web Site" -ExternalURL "https://www.contoso.com/Microsoft-Server-ActiveSync"