Set-ActiveSyncVirtualDirectory

Artikel
09/29/2014

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