Set-EcpVirtualDirectory
このコマンドレットは、オンプレミスの Exchange でのみ使用可能です。
Set-EcpVirtualDirectory コマンドレットを使用して、Microsoft Exchange サーバー上のインターネット インフォメーション サービス (IIS) で使用される Exchange コントロール パネル (ECP) 仮想ディレクトリを変更します。 ECP 仮想ディレクトリは、Exchange 管理センターを管理します。
ECP Web 管理インターフェイスは、Exchange Server 2010 で導入されました。 Exchange Server 2013 および Exchange Server 2016 では、EAC 仮想ディレクトリと対応する管理コマンドレットは、名前に ECP を引き続き使用します。 これらのコマンドレットを使用して、Exchange 2010、Exchange 2013、および Exchange 2016 サーバー上の ECP 仮想ディレクトリを管理できます。
以下の構文セクションのパラメーター セットの詳細については、「Exchangeのコマンドレット構文」を参照してください。
構文
Set-EcpVirtualDirectory
[-Identity] <VirtualDirectoryIdParameter>
[-AdfsAuthentication <Boolean>]
[-AdminEnabled <Boolean>]
[-BasicAuthentication <Boolean>]
[-Confirm]
[-DigestAuthentication <Boolean>]
[-DomainController <Fqdn>]
[-ExtendedProtectionFlags <MultiValuedProperty>]
[-ExtendedProtectionSPNList <MultiValuedProperty>]
[-ExtendedProtectionTokenChecking <ExtendedProtectionTokenCheckingMode>]
[-ExternalAuthenticationMethods <MultiValuedProperty>]
[-ExternalUrl <Uri>]
[-FormsAuthentication <Boolean>]
[-GzipLevel <GzipLevel>]
[-InternalUrl <Uri>]
[-OwaOptionsEnabled <Boolean>]
[-WhatIf]
[-WindowsAuthentication <Boolean>]
[<CommonParameters>] 説明
このコマンドレットを実行する際には、あらかじめアクセス許可を割り当てる必要があります。 このトピックにはこのコマンドレットのすべてのパラメーターが一覧表示されていますが、自分に割り当てられているアクセス許可に含まれていない一部のパラメーターにはアクセスできません。 コマンドレットを組織内で実行するために必要になるアクセス許可とパラメーターを調べるには、「 Find the permissions required to run any Exchange cmdlet」を参照してください。
例
例 1
Set-EcpVirtualDirectory -Identity "Server01\ecp (Default Web site)" -BasicAuthentication:$falseこの例では、Server01 というサーバー上の既定の ECP 仮想ディレクトリで基本認証を無効にします。
例 2
Set-EcpVirtualDirectory -Identity "Server01\ecp (Default Web site)" -AdminEnabled $false次の使用例は、Server01 というサーバー上の EAC へのインターネット アクセスをオフにします。
パラメーター
-AdfsAuthentication
AdfsAuthentication パラメーターは、ECP 仮想ディレクトリでユーザーが Active Directory フェデレーション サービス (AD FS) (AD FS) 認証を介して認証できるように指定します。 このパラメーターには $true または $false を指定できます。 既定値は $false です。
Set-OwaVirtualDirectory と Set-EcpVirtualDirectory の ADFS 認証の設定には関連があります。 Set-OwaVirtualDirectory の AdfsAuthentication パラメーターを $true に設定する前に、Set-EcpVirtualDirectory の AdfsAuthentication パラメーターを $true に設定する必要があります。 同様に、Set-EcpVirtualDirectory の AdfsAuthentication パラメーターを $false に設定する前に、Set-OwaVirtualDirectory の AdfsAuthentication パラメーターを $false に設定する必要があります。
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-AdminEnabled
AdminEnabled パラメーターは、インターネットで EAC にアクセスできないようにすることを指定します。 詳細については、「Exchange 管理センターへのアクセスをオフにする」をご覧ください。 このパラメーターには $true または $false を指定できます。
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-BasicAuthentication
BasicAuthentication パラメーターは、仮想ディレクトリで基本認証を有効にするかどうかを指定します。 有効な値は次のとおりです。
- $true: 基本認証が有効になっています。 これは既定の値です。
- $true: 基本認証を有効にします。これが既定値です。
このパラメーターを FormsAuthentication パラメーターや DigestAuthentication パラメーターおよび WindowsAuthentication パラメーターと一緒に使用することはできません。
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Confirm
Confirm スイッチは、確認プロンプトを表示するか非表示にするかを指定します。 このスイッチがコマンドレットにどのような影響を与えるかは、先に進む前にコマンドレットで確認が必要となるかどうかで決まります。
- 破壊的なコマンドレット (Remove-* コマンドレットなど) には、続行する前にコマンドの確認を強制する組み込みの一時停止があります。 これらのコマンドレットでは、正確な構文
-Confirm:$falseを使用して、確認プロンプトを省略できます。 - 他のほとんどのコマンドレット (New-* コマンドレットや Set-* コマンドレットなど) には、一時停止が組み込まれています。 これらのコマンドレットの場合、値なしで Confirm スイッチを指定すると、先に進む前に、一時停止してコマンドを確認する必要があります。
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-DigestAuthentication
DigestAuthentication パラメーターは、ダイジェスト認証が仮想ディレクトリで有効かどうかを指定します。 有効な値は次のとおりです。
- $true: ダイジェスト認証が有効になっています。
- $false: ダイジェスト認証が無効になっています。 これは既定の値です。
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-DomainController
DomainController パラメーターは、このコマンドレットで Active Directory からのデータの読み取りまたは Active Directory へのデータの書き込みに使用されるドメイン コントローラーを指定します。 ドメイン コントローラーは、完全修飾ドメイン名 (FQDN) で識別します。 たとえば、dc01.contoso.com です。
| Type: | Fqdn |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-ExtendedProtectionFlags
ExtendedProtectionFlags パラメーターは、仮想ディレクトリでの認証の拡張保護のカスタム設定を指定します。 有効な値は次のとおりです。
- [なし] : 既定の設定です。
- AllowDotlessSPN: FQDN (HTTP/mail.contoso.com ではなく HTTP/ContosoMail など) を含まないサービス プリンシパル名 (SPN) 値を使用する場合は必須です。 SPN は ExtendedProtectionSPNList パラメーターで指定します。 この設定では、ドットレス証明書が一意ではないので、セキュリティで保護されたチャネル経由でクライアントとプロキシの接続が確立されたことを確認できないため、認証の拡張保護のセキュリティが低下します。
- NoServiceNameCheck: SPN リストは、チャネル バインド トークンを検証するためにチェックされません。 この設定により、認証の拡張保護のセキュリティが低下します。 通常、この設定はお勧めしません。
- プロキシ: プロキシ サーバーは、SSL チャネルの終了を担当します。 この設定を使用するには、ExtendedProtectionSPNList パラメーターを使用して SPN を登録する必要があります。
- ProxyCoHosting: HTTP トラフィックと HTTPS トラフィックが仮想ディレクトリにアクセスしている可能性があり、プロキシ サーバーは少なくとも一部のクライアントと Exchange サーバー上のクライアント アクセス サービスの間にあります。
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-ExtendedProtectionSPNList
ExtendedProtectionSPNList パラメーターは、仮想ディレクトリで認証に拡張保護を使用している場合に、有効なサービス プリンシパル名 (SPN) の一覧を指定します。 有効な値は次のとおりです。
- $null: これが既定値です。
- 有効な SPN の単一 SPN またはコンマ区切りリスト: SPN 値の形式は です
Protocol\FQDN。 たとえば、HTTP/mail.contoso.com です。 FQDN ではない SPN (HTTP/ContosoMail など) を追加するには、ExtendedProtectionFlags パラメーターに AllowDotlessSPN 値も使用する必要があります。
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-ExtendedProtectionTokenChecking
ExtendedProtectionTokenChecking パラメーターは、仮想ディレクトリで認証に拡張保護を使用する方法を定義します。 既定では、認証の拡張保護は有効になっていません。 有効な値は次のとおりです。
- なし: 認証の拡張保護は、仮想ディレクトリでは使用されません。 これは既定の値です。
- None: 認証の拡張保護は仮想ディレクトリでは使用されません。 これが既定値です。
- 必須: 認証の拡張保護は、クライアントと仮想ディレクトリ間のすべての接続に使用されます。 クライアントまたはサーバーがサポートしていない場合、接続は失敗します。 この値を使用する場合は、ExtendedProtectionSPNList パラメーターの SPN 値も設定する必要があります。
注: [許可] または [必須] の値を使用し、クライアントからプロキシへの SSL チャネルを終了するように構成されているメールボックス サーバー上のクライアントとクライアント アクセス サービスの間にプロキシ サーバーがある場合は、ExtendedProtectionSPNList パラメーターを使用して 1 つ以上のサービス プリンシパル名 (SPN) を構成する必要もあります。
| Type: | ExtendedProtectionTokenCheckingMode |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-ExternalAuthenticationMethods
ExternalAuthenticationMethods パラメーターは、ファイアウォールの外部から Exchange サーバーでサポートされる認証方法を指定します。
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-ExternalUrl
ExternalURL パラメーターは、ファイアウォールの外側から仮想ディレクトリへの接続に使用される URL を指定します。
この設定は、SSL (Secure Sockets Layer) を使用する場合にも重要です。 自動検出サービスが ECP 仮想ディレクトリの URL を返せるようにするには、このパラメーターを設定する必要があります。
| Type: | Uri |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-FormsAuthentication
FormsAuthentication パラメーターは、ECP 仮想ディレクトリに対してフォームベース認証を有効にするかどうかを指定します。 有効な値は次のとおりです。
- $true: フォーム認証が有効になっています。 BasicAuthentication パラメーターは $true に設定され、DigestAuthentication パラメーターと WindowsAuthentication パラメーターは $false に設定されます。
- $false: フォーム認証が無効になっています。
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-GzipLevel
GzipLevel パラメーターは、ECP 仮想ディレクトリの Gzip 構成情報を設定します。
| Type: | GzipLevel |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Identity
Identity パラメーターは、変更する ECP 仮想ディレクトリを指定します。 仮想ディレクトリを一意に識別する任意の値を使用できます。 例:
- 名前またはサーバー\Name
- 識別名 (DN)
- GUID
Name 値は、仮想ディレクトリのプロパティの構文 "VirtualDirectoryName (WebsiteName)" を使用します。 構文 VirtualDirectoryName*を使用して、既定の Web サイトの代わりにワイルドカード文字 (*) を指定できます。
Exchange 組織で作成された最初の ECP 仮想ディレクトリを管理するには、最初の ECP 仮想ディレクトリを含むコンピューターでこのコマンドレットを使用する必要があります。 追加の ECP 仮想ディレクトリを作成した場合、それらをリモートから管理できます。
| Type: | VirtualDirectoryIdParameter |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-InternalUrl
InternalURL パラメーターは、ファイアウォールの内側から仮想ディレクトリへの接続に使用される URL を指定します。
この設定は、SSL を使用する場合にも重要です。 自動検出サービスが ECP 仮想ディレクトリの URL を返せるようにするには、このパラメーターを設定する必要があります。
| Type: | Uri |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-OwaOptionsEnabled
OwaOptionsEnabled パラメーターは、エンド ユーザーに対して Outlook on the web Options が有効になっていることを指定します。 このパラメーターが $false に設定されている場合、ユーザーは Outlook on the web オプションにアクセスできません。 組織でサードパーティ プロバイダーのツールを使用している場合は、アクセスを無効にすることもあります。 このパラメーターには $true または $false を指定できます。
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-WhatIf
WhatIf スイッチは、コマンドの操作をシミュレートします。 このスイッチを使用すると、実際にその変更内容を適用せずに、発生する変更を確認できます。 このスイッチで値を指定する必要はありません。
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-WindowsAuthentication
WindowsAuthentication パラメーターは、仮想ディレクトリで統合Windows 認証を有効にするかどうかを指定します。 有効な値は次のとおりです。
- $true: 統合Windows 認証が有効になっています。 これは既定の値です。
- $false: 統合Windows 認証が無効になっています。
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
入力
Input types
このコマンドレットに使用できる入力の種類を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。 コマンドレットで入力の種類のフィールドが空白の場合、そのコマンドレットには入力データを指定できません。
出力
Output types
このコマンドレットに使用できる戻り値の型 (出力の種類) を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。 出力の種類のフィールドが空白の場合、コマンドレットはデータを返しません。