Freigeben über


Set-ActiveSyncVirtualDirectory

 

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

Letztes Änderungsdatum des Themas: 2012-03-26

Das Cmdlet Set-ActiveSyncVirtualDirectory ermöglicht Ihnen, die Microsoft Exchange ActiveSync-Einstellungen für ein angegebenes virtuelles Verzeichnis zu konfigurieren.

Syntax

Set-ActiveSyncVirtualDirectory -Identity <VirtualDirectoryIdParameter> [-ActiveSyncServer <String>] [-BadItemReportingEnabled <$true | $false>] [-BasicAuthEnabled <$true | $false>] [-ClientCertAuth <Ignore | Accepted | Required>] [-CompressionEnabled <$true | $false>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-ExternalAuthenticationMethods <MultiValuedProperty>] [-ExternalUrl <Uri>] [-InstallIsapiFilter <$true | $false>] [-InstallProxySubDirectory <$true | $false>] [-InternalAuthenticationMethods <MultiValuedProperty>] [-InternalUrl <Uri>] [-MobileClientCertificateAuthorityURL <String>] [-MobileClientCertificateProvisioningEnabled <$true | $false>] [-MobileClientCertTemplateName <String>] [-Name <String>] [-RemoteDocumentsActionForUnknownServers <Nullable>] [-RemoteDocumentsAllowedServers <MultiValuedProperty>] [-RemoteDocumentsBlockedServers <MultiValuedProperty>] [-RemoteDocumentsInternalDomainSuffixList <MultiValuedProperty>] [-WhatIf [<SwitchParameter>]] [-WindowsAuthEnabled <$true | $false>]

Set-ActiveSyncVirtualDirectory [-ActiveSyncServer <String>] [-BadItemReportingEnabled <$true | $false>] [-BasicAuthEnabled <$true | $false>] [-ClientCertAuth <Ignore | Accepted | Required>] [-CompressionEnabled <$true | $false>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-ExternalAuthenticationMethods <MultiValuedProperty>] [-ExternalUrl <Uri>] [-InstallIsapiFilter <$true | $false>] [-InstallProxySubDirectory <$true | $false>] [-Instance <ADMobileVirtualDirectory>] [-InternalAuthenticationMethods <MultiValuedProperty>] [-InternalUrl <Uri>] [-MobileClientCertificateAuthorityURL <String>] [-MobileClientCertificateProvisioningEnabled <$true | $false>] [-MobileClientCertTemplateName <String>] [-Name <String>] [-RemoteDocumentsActionForUnknownServers <Nullable>] [-RemoteDocumentsAllowedServers <MultiValuedProperty>] [-RemoteDocumentsBlockedServers <MultiValuedProperty>] [-RemoteDocumentsInternalDomainSuffixList <MultiValuedProperty>] [-WhatIf [<SwitchParameter>]] [-WindowsAuthEnabled <$true | $false>]

Detaillierte Beschreibung

Mithilfe des Befehls Set-ActiveSyncVirtualDirectory können Sie zahlreiche Einstellungen für das virtuelle Verzeichnis erstellen, das für Exchange ActiveSync verwendet wird.

Damit Sie das Cmdlet Set-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 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 das zu konfigurierende virtuelle Exchange ActiveSync-Verzeichnis eindeutig an. Dieser Wert muss website\microsoft-server-activesync sein.

ActiveSyncServer

Optional

System.String

Dieser Parameter gibt den URL des Clientzugriffsservers an. Dieser weist folgendes Format auf: https://servername/Microsoft-Server-ActiveSync.

BadItemReportingEnabled

Optional

System.Boolean

Dieser Parameter gibt an, ob Elemente, die nicht synchronisiert werden können, an den Benutzer gemeldet werden. Wenn der Parameter auf $true festgelegt wird, erhält der Benutzer eine Benachrichtigung, wenn ein Element nicht mit dem mobilen Gerät synchronisiert werden kann.

BasicAuthEnabled

Optional

System.Boolean

Dieser Parameter aktiviert oder deaktiviert die Standardauthentifizierung. Die Standardeinstellung ist $true.

ClientCertAuth

Optional

Microsoft.Exchange.Data.Directory.SystemConfiguration.ClientCertAuthTypes

Dieser Parameter gibt den Status der Clientzertifikatsauthentifizierung an. Standardmäßig ist die Clientzertifikatsauthentifizierung deaktiviert. Der Standardwert für diesen Parameter ist $null.

CompressionEnabled

Optional

System.Boolean

Bei diesem Parameter handelt es sich um eine ganze Zahl, die die Komprimierung festlegt, die auf das angegebene virtuelle Exchange ActiveSync-Verzeichnis angewendet wird. Die Standardeinstellung ist $true.

Confirm

Optional

System.Management.Automation.SwitchParameter

Dieser Parameter bewirkt eine Unterbrechung der Befehlsausführung und zwingt den Benutzer, die Aktion des Befehls zu bestätigen, bevor die Verarbeitung fortgesetzt wird. Für den Parameter Confirm muss kein Wert angegeben werden.

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 den Active Directory-Verzeichnisdienst 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 zu verwendenden URL an, wenn außerhalb der Netzwerkfirewall auf das virtuelle Verzeichnis zugegriffen wird.

InstallIsapiFilter

Optional

System.Boolean

Der Parameter InstallIsapiFilter gibt an, ob der ISAPI-Filter (Internet Server API) installiert ist.

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. 

Instance

Optional

Microsoft.Exchange.Data.Directory.SystemConfiguration.ADMobileVirtualDirectory

Der Parameter Instance ermöglicht das Übergeben eines vollständigen Objekts an den zu verarbeitenden Befehl. Er wird hauptsächlich in Skripts verwendet, in denen ein vollständiges Objekt an den Befehl übergeben werden muss.

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 wird für die HTTP-Proxyfunktion für den Clientzugriffsserver verwendet. Wenn dieser Parameter festgelegt ist, leitet der Clientzugriffsserver, der die eingehenden Clientverbindungen erhält, die Anforderungen an diesen URL über einen Proxy. Dies kann ein URL eines vollqualifizierten Domänennamens (FQDN) für das Internet oder ein interner Hostname sein.

MobileClientCertificateAuthorityURL

Optional

System.String

Dieser Parameter gibt den URL für die Zertifizierungsstelle (Certification Authority, CA) an, der von dem mobilen Gerät verwendet wird.

MobileClientCertificateProvisioningEnabled

Optional

System.Boolean

Dieser Parameter gibt an, ob der AutoErmittlungsdienst den URL des Zertifikatsdiensteservers in der XML-Datei zurückgibt.

MobileClientCertTemplateName

Optional

System.String

Dieser Parameter gibt den Namen der Vorlage für das Clientzertifikat an.

Name

Optional

System.String

Dieser Parameter gibt den Namen des virtuellen Exchange ActiveSync-Verzeichnisses an.

RemoteDocumentsActionForUnknownServers

Optional

System.Nullable

Dieser Parameter gibt die Aktion an, die durchgeführt wird, wenn eine Windows SharePoint Services-Anforderung oder eine Windows-Dateifreigabeanforderung über Exchange ActiveSync eingeht. Wenn eine Anforderung eintrifft, sucht Exchange ActiveSync in den Zulassungs- und Sperrlisten nach dem angeforderten Hostnamen. Wird der Hostname in keiner der Listen gefunden, wird die in diesem Parameter festgelegte Aktion (Blockieren oder Zulassen) durchgeführt.

RemoteDocumentsAllowedServers

Optional

Microsoft.Exchange.Data.MultiValuedProperty

Bei diesem Parameter handelt es sich um eine mehrwertige Eigenschaft, die alle zugelassenen Server für den Remotedokumentzugriff auflistet.

RemoteDocumentsBlockedServers

Optional

Microsoft.Exchange.Data.MultiValuedProperty

Bei diesem Parameter handelt es sich um eine mehrwertige Eigenschaft, die alle geblockten Server für den Remotedokumentzugriff auflistet.

RemoteDocumentsInternalDomainSuffixList

Optional

Microsoft.Exchange.Data.MultiValuedProperty

Dieser Parameter wird in Organisationen verwendet, in deren Netzwerk WINS nicht verwendet wird. In diesen Umgebungen können Sie einen oder mehrere FQDNs angeben, die Exchange ActiveSync als intern behandelt, wenn eine Anforderung für Remotedateizugriff eingeht.

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 dieses Parameters können Sie eine Vorschau der Änderungen anzeigen, ohne diese Änderungen wirklich übernehmen zu müssen. Sie brauchen für diesen Parameter keinen Wert anzugeben.

WindowsAuthEnabled

Optional

System.Boolean

Dieser Parameter gibt an, ob die Integrierte Windows-Authentifizierung für das virtuelle Exchange ActiveSync-Verzeichnis aktiviert ist.

Eingabetypen

Rückgabetypen

Fehler

Fehler Beschreibung

 

 

Ausnahmen

Ausnahmen Beschreibung

 

 

Beispiel

Im folgenden Codebeispiel wird die Standardauthentifizierung in dem virtuellen Exchange ActiveSync-Standardverzeichnis auf dem Server mit der Bezeichnung Contoso deaktiviert.

Set-ActiveSyncVirtualDirectory -Identity "contoso\microsoft-server-activesync" -BasicAuthEnabled:$false