Set-ActiveSyncVirtualDirectory
適用先: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
トピックの最終更新日: 2012-03-26
Set-ActiveSyncVirtualDirectory コマンドを使用すると、指定した仮想ディレクトリに関する Microsoft Exchange ActiveSync の設定を構成できます。
構文
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>]
解説
Set-ActiveSyncVirtualDirectory コマンドを使用すると、Exchange ActiveSync 用に使用される仮想ディレクトリに関するさまざまな設定を構成できます。
Set-ActiveSyncVirtualDirectory コマンドレットを実行するには、使用するアカウントに Exchange Server Administrator の役割および対象サーバーのローカルの Administrators グループのメンバシップが委任されている必要があります。
アクセス許可、役割の委任、および Microsoft Exchange Server 2007 を管理するために必要な権限の詳細については、「アクセス許可に関する考慮事項」を参照してください。
パラメータ
パラメータ | 必須かどうか | 種類 | 説明 |
---|---|---|---|
Identity |
必須 |
Microsoft.Exchange.Configuration.Tasks.VirtualDirectoryIdParameter |
このパラメータは、構成する Exchange ActiveSync 仮想ディレクトリを一意に識別します。この値は、website\microsoft-server-activesync である必要があります。 |
ActiveSyncServer |
省略可能 |
System.String |
このパラメータには、クライアント アクセス サーバーの URL を指定します。https://servername/Microsoft-Server-ActiveSync という形式で指定してください。 |
BadItemReportingEnabled |
省略可能 |
System.Boolean |
このパラメータには、同期できないアイテムをユーザーに報告するかどうかを指定します。 |
BasicAuthEnabled |
省略可能 |
System.Boolean |
このパラメータは、基本認証を有効または無効にします。既定の設定は |
ClientCertAuth |
省略可能 |
Microsoft.Exchange.Data.Directory.SystemConfiguration.ClientCertAuthTypes |
このパラメータには、クライアント証明書の認証の状態を指定します。既定では、クライアント証明書の認証は無効に設定されています。このパラメータの既定値は、 |
CompressionEnabled |
省略可能 |
System.Boolean |
このパラメータは、指定した Exchange ActiveSync 仮想ディレクトリに適用される圧縮を識別する整数です。既定の設定は |
Confirm |
省略可能 |
System.Management.Automation.SwitchParameter |
このパラメータを指定すると、コマンドの処理が一時停止します。処理を続行するためには管理者がコマンドの処理内容を確認する必要があります。Confirm パラメータで値を指定する必要はありません。 |
DomainController |
省略可能 |
Microsoft.Exchange.Data.Fqdn |
この構成の変更を Active Directory ディレクトリ サービスに書き込むドメイン コントローラの完全修飾ドメイン名 (FQDN) を指定するには、コマンドに DomainController パラメータを含めます。 |
ExternalAuthenticationMethods |
省略可能 |
Microsoft.Exchange.Data.MultiValuedProperty |
このパラメータには、ネットワークのファイアウォールの外側からアクセスを要求されたときに、仮想ディレクトリを含むサーバーがサポートしている認証方法を指定します。このパラメータを設定しない場合は、すべての認証方法を使用できます。 |
ExternalUrl |
省略可能 |
System.Uri |
このパラメータには、ネットワークのファイアウォールの外側から仮想ディレクトリへの接続に使用される URL を指定します。 |
InstallIsapiFilter |
省略可能 |
System.Boolean |
InstallIsapiFilter パラメータでは、Internet Server API (ISAPI) フィルタがインストールされるかどうかを指定します。 |
InstallProxySubDirectory |
省略可能 |
System.Boolean |
InstallProxySubDirectory パラメータは、Microsoft Exchange Server 2010 と Exchange Server 2007 の間でプロキシとして使用される新しい Exchange ActiveSync サブディレクトリの作成方法を制御します。 |
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 を指定できます。 |
WhatIf |
省略可能 |
System.Management.Automation.SwitchParameter |
このパラメータは、オブジェクトに対して行われる操作をシミュレートすることを指定します。このパラメータを使用することで、実際に変更を加えずに、発生する変更内容を表示できます。このパラメータに値を指定する必要はありません。 |
WindowsAuthEnabled |
省略可能 |
System.Boolean |
Exchange ActiveSync 仮想ディレクトリに対して統合 Windows 認証を有効にするかどうかを指定します。 |
入力の種類
戻り値の種類
エラー
エラー | 説明 |
---|---|
|
|
例外
例外 | 説明 |
---|---|
|
|
例
次のコード例は、Contoso という名前のサーバー上の既定の Exchange ActiveSync 仮想ディレクトリで基本認証を無効にします。
Set-ActiveSyncVirtualDirectory -Identity "contoso\microsoft-server-activesync" -BasicAuthEnabled:$false
参照している情報が最新であることを確認したり、他の Exchange Server 2007 ドキュメントを見つけたりするには、Exchange Server TechCenter を参照してください。