New-ActiveSyncVirtualDirectory

 

Gilt für: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

Letztes Änderungsdatum des Themas: 2009-05-14

Mit dem Befehl New-ActiveSyncVirtualDirectory können Sie ein neues virtuelles Microsoft Exchange ActiveSync ActiveSync-Verzeichnis auf Ihren angegebenen Websites erstellen.

Syntax

New-ActiveSyncVirtualDirectory [-ApplicationRoot <String>] [-AppPoolId <String>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-ExternalAuthenticationMethods <MultiValuedProperty>] [-ExternalUrl <Uri>] [-InstallProxySubDirectory <$true | $false>] [-InternalAuthenticationMethods <MultiValuedProperty>] [-InternalUrl <Uri>] [-Path <String>] [-TemplateInstance <PSObject>] [-WebSiteName <String>] [-WhatIf [<SwitchParameter>]]

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 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 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.

Confirm

Optional

System.Management.Automation.SwitchParameter

Der Parameter Confirm bewirkt, dass der Befehl die Verarbeitung anhält und der Administrator die Ausführung des Befehls vor der weiteren Verarbeitung bestätigen. Der Standardwert lautet "$true".

DomainController

Optional

Microsoft.Exchange.Data.Fqdn

Dieser Parameter gibt den vollqualifizierten Domänennamen (FQDN) des Domänencontrollers an, der diese Konfigurationsänderung in den Active Directory-Verzeichnisdienst schreibt.

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 zu verwendenden URL an, wenn außerhalb der Firewall des Netzwerks auf das virtuelle Verzeichnis zugegriffen wird.

InstallProxySubDirectory

Optional

System.Boolean

Der Parameter InstallProxySubDirectory steuert, wie das neue Exchange ActiveSync-Unterverzeichnis erstellt wird, das als Proxy zwischen Microsoft Exchange Server 2010 und Exchange Server 2007 verwendet wird. 

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.

TemplateInstance

Optional

System.Management.Automation.PSObject

Dieser Parameter gibt an, dass das Cmdlet die Konfiguration eines vorhandenen Objekts verwendet, wenn das Objekt diesem Parameter übergeben wird, um das Objekt auf dem lokalen oder einem Zielserver zu duplizieren.

WebSiteName

Optional

System.String

Dieser Parameter legt den Namen der Exchange ActiveSync-Website fest, auf der das neue virtuelle Verzeichnis erstellt wird.

WhatIf

Optional

System.Management.Automation.SwitchParameter

Dieser Parameter weist den Befehl an, die Aktionen zu simulieren, die für das Objekt ausgeführt würden. Durch Verwendung des Parameters WhatIf kann der Administrator die sich ergebenden Änderungen anzeigen, ohne diese Änderungen tatsächlich auszuführen. Der Standardwert lautet "$false".

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 "Default Web Site" -ExternalURL "https://www.contoso.com/Microsoft-Server-ActiveSync"