Set-ActiveSyncVirtualDirectory (RTM)

  • [アーティクル]

 

適用先: Exchange Server 2007

トピックの最終更新日: 2007-06-11

Set-ActiveSyncVirtualDirectory コマンドを使用すると、指定した仮想ディレクトリに関する Microsoft ActiveSync の設定を構成できます。

構文

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

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

解説

Set-ActiveSyncVirtualDirectory コマンドを使用すると、Exchange ActiveSync 用に使用される仮想ディレクトリに関するさまざまな設定を構成できます。

Set-ActiveSyncVirtualDirectory コマンドレットを実行するには、使用するアカウントに次の権限が委任されている必要があります。

  • Exchange サーバー管理者の役割および対象サーバーのローカル Administrators グループ

Exchange Server 2007 を管理するために必要なアクセス許可、役割の委任、および権限の詳細については、「アクセス許可に関する考慮事項」を参照してください。

パラメータ

パラメータ 必須かどうか 種類 説明

Identity

必須

Microsoft.Exchange.Configuration.Tasks.VirtualDirectoryIdParameter

このパラメータは、構成する Exchange ActiveSync 仮想ディレクトリを一意に識別します。この値は、website\microsoft-server-activesync である必要があります。

ActiveSyncServer

省略可能

System.String

このパラメータには、クライアント アクセス サーバーの URL を指定します。この URL は、https://servername/Microsoft-Server-ActiveSync という形式になります。

BadItemReportingEnabled

省略可能

System.Boolean

このパラメータには、同期できないアイテムをユーザーに報告するかどうかを指定します。$true に設定した場合、アイテムをモバイル デバイスに同期できないときにはユーザーに通知されます。

BasicAuthEnabled

省略可能

System.Boolean

このパラメータは、基本認証を有効または無効にします。既定の設定は $true です。

ClientCertAuth

省略可能

Microsoft.Exchange.Data.Directory.SystemConfiguration.ClientCertAuthTypes

このパラメータには、クライアント証明書の認証の状態を指定します。既定では、クライアント証明書の認証は無効に設定されています。このパラメータの既定値は、$null です。

CompressionEnabled

省略可能

System.Boolean

このパラメータは、指定した Exchange ActiveSync 仮想ディレクトリに適用される圧縮を識別する整数です。既定の設定は $true です。

DomainController

省略可能

Microsoft.Exchange.Data.Fqdn

この構成の変更を Active Directory ディレクトリ サービスに書き込むドメイン コントローラの完全修飾ドメイン名 (FQDN) を指定するには、コマンドに DomainController パラメータを含めます。

ExternalAuthenticationMethods

省略可能

Microsoft.Exchange.Data.MultiValuedProperty

このパラメータには、ネットワークのファイアウォールの外側からアクセスを要求されたときに、仮想ディレクトリを含むサーバーがサポートしている認証方法を指定します。このパラメータを設定しない場合は、すべての認証方法を使用できます。

ExternalUrl

省略可能

System.Uri

このパラメータには、ネットワークのファイアウォールの外側から仮想ディレクトリへの接続に使用される URL を指定します。

Instance

省略可能

Microsoft.Exchange.Data.Directory.SystemConfiguration.ADMobileVirtualDirectory

Instance パラメータを使用すると、オブジェクト全体をコマンドに渡して処理することができます。オブジェクト全体をコマンドに渡す必要があるスクリプトで主に使用されます。

InternalAuthenticationMethods

省略可能

Microsoft.Exchange.Data.MultiValuedProperty

このパラメータには、ネットワークのファイアウォールの内側からアクセスを要求されたときに、仮想ディレクトリを含むサーバーがサポートしている認証方法を指定します。このパラメータを設定しない場合は、すべての認証方法を使用できます。

InternalUrl

省略可能

System.Uri

このパラメータは、クライアント アクセス サーバーの HTTP プロキシ機能で使用されます。このパラメータが設定されている場合、受信クライアント接続を受信したクライアント アクセス サーバーは要求をこの URL にプロキシします。このパラメータには、インターネットに公開されている完全修飾ドメイン名 (FQDN) の URL または内部ホスト名を指定できます。

MobileClientCertificateAuthorityURL

省略可能

System.String

このパラメータには、モバイル デバイスで使用される証明機関 (CA) の URL を指定します。

MobileClientCertificateProvisioningEnabled

省略可能

System.Boolean

このパラメータには、自動検出サービスが証明書サービス サーバーの URL を XML ファイルで返すかどうかを指定します。

MobileClientCertTemplateName

省略可能

System.String

このパラメータには、クライアント証明書のテンプレート名を指定します。

Name

省略可能

System.String

このパラメータには、Exchange ActiveSync 仮想ディレクトリの名前を指定します。

RemoteDocumentsActionForUnknownServers

省略可能

System.Nullable

このパラメータには、Windows SharePoint Services または Windows ファイル共有の要求を Exchange ActiveSync 経由で受信したときに実行するアクションを指定します。要求を受信したときに、Exchange ActiveSync は要求されたホスト名を許可一覧と禁止一覧で検索します。ホスト名がいずれの一覧にも見つからない場合は、このパラメータで指定した禁止 (Block) または許可 (Allow) のいずれかのアクションが実行されます。

RemoteDocumentsAllowedServers

省略可能

Microsoft.Exchange.Data.MultiValuedProperty

このパラメータは、リモート ドキュメントへのアクセスが許可されているすべてのサーバーを一覧表示する複数値プロパティです。

RemoteDocumentsBlockedServers

省略可能

Microsoft.Exchange.Data.MultiValuedProperty

このパラメータは、リモート ドキュメントへのアクセスが禁止されているすべてのサーバーを一覧表示する複数値プロパティです。

RemoteDocumentsInternalDomainSuffixList

省略可能

Microsoft.Exchange.Data.MultiValuedProperty

このパラメータは、ネットワーク内で WINS を実行していない組織で使用されます。このような環境では、リモート ファイル アクセスの要求を受信したときに Exchange ActiveSync が内部の要求として処理する FQDN を指定できます。

入力の種類

戻り値の種類

エラー

エラー 説明

 

 

例外

例外 説明

 

 

例

次のコード例は、Contoso という名前のサーバー上の既定の Exchange ActiveSync 仮想ディレクトリで基本認証を無効します。

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

参照している情報が最新であることを確認したり、他の Exchange Server 2007 ドキュメントを見つけたりするには、Exchange Server TechCenter を参照してください。