New-WebServicesVirtualDirectory
このコマンドレットは、オンプレミスの Exchange でのみ使用可能です。
New-WebServicesVirtualDirectory コマンドレットを使用して、Microsoft Exchange サーバー上のインターネット インフォメーション サービス (IIS) で使用される Exchange Web サービス仮想ディレクトリを作成します。
このコマンドレットでは、複数の仮想ディレクトリを作成できます。 ただし、Web サイトごとに作成できる Exchange Web サービス仮想ディレクトリは 1 つだけです。
以下の構文セクションのパラメーター セットの詳細については、「Exchangeのコマンドレット構文」を参照してください。
構文
Default (既定)
New-WebServicesVirtualDirectory
[-ApplicationRoot <String>]
[-AppPoolId <String>]
[-AppPoolIdForManagement <String>]
[-BasicAuthentication <Boolean>]
[-Confirm]
[-DigestAuthentication <Boolean>]
[-DomainController <Fqdn>]
[-ExtendedProtectionFlags <MultiValuedProperty>]
[-ExtendedProtectionSPNList <MultiValuedProperty>]
[-ExtendedProtectionTokenChecking <ExtendedProtectionTokenCheckingMode>]
[-ExternalUrl <Uri>]
[-Force]
[-GzipLevel <GzipLevel>]
[-InternalNLBBypassUrl <Uri>]
[-InternalUrl <Uri>]
[-MRSProxyEnabled <Boolean>]
[-MRSProxyMaxConnections <Unlimited>]
[-OAuthAuthentication <Boolean>]
[-Path <String>]
[-Role <VirtualDirectoryRole>]
[-Server <ServerIdParameter>]
[-WebSiteName <String>]
[-WhatIf]
[-WindowsAuthentication <Boolean>]
[-WSSecurityAuthentication <Boolean>]
[<CommonParameters>]
説明
このコマンドレットを実行する際には、あらかじめアクセス許可を割り当てる必要があります。 この記事ではコマンドレットのすべてのパラメーターを一覧表示しますが、割り当てられたアクセス許可にパラメーターが含まれていない場合は、一部のパラメーターにアクセスできない可能性があります。 コマンドレットを組織内で実行するために必要になるアクセス許可とパラメーターを調べるには、「 Find the permissions required to run any Exchange cmdlet」を参照してください。
例
例 1
New-WebServicesVirtualDirectory -WebSiteName "www.contoso.com" -ExternalUrl "https://www.contoso.com/webservices.aspx"
この例では、既定以外の Web サイト www.contoso.com
の下に仮想ディレクトリを作成します。 また、外部 URL を https://www.contoso.com/webservices.aspx
に設定します。
パラメーター
-ApplicationRoot
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
ApplicationRoot パラメーターには、仮想ディレクトリのメタベース パスを指定します。 既定では、このパスは仮想ディレクトリが作成された Web サイトと同じです。
パラメーターのプロパティ
型: | String |
規定値: | None |
ワイルドカードのサポート: | False |
DontShow: | False |
パラメーター セット
(All)
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-AppPoolId
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
AppPoolId パラメーターは、仮想ディレクトリが機能する IIS アプリケーション プールを指定します。 このパラメーターを既定の設定のままにすることをお勧めします。
パラメーターのプロパティ
型: | String |
規定値: | None |
ワイルドカードのサポート: | False |
DontShow: | False |
パラメーター セット
(All)
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-AppPoolIdForManagement
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
AppPoolIdForManagement パラメーターには、仮想ディレクトリを管理するプログラム プールを指定します。
パラメーターのプロパティ
型: | String |
規定値: | None |
ワイルドカードのサポート: | False |
DontShow: | False |
パラメーター セット
(All)
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-BasicAuthentication
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
BasicAuthentication パラメーターは、仮想ディレクトリで基本認証を有効にするかどうかを指定します。 有効な値は次のとおりです。
- $true: 基本認証が有効になっています。 この値が既定値です。
- $true: 基本認証を有効にします。これが既定値です。
パラメーターのプロパティ
型: | Boolean |
規定値: | None |
ワイルドカードのサポート: | False |
DontShow: | False |
パラメーター セット
(All)
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-Confirm
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
Confirm スイッチは、確認プロンプトを表示するか非表示にするかを指定します。 このスイッチがコマンドレットにどのような影響を与えるかは、先に進む前にコマンドレットで確認が必要となるかどうかで決まります。
- データを破壊するコマンドレット (たとえば、Remove- コマンドレット) には、先に進む前にユーザーにそのコマンドの確認を強制する組み込みの一時停止があります。 これらのコマンドレットでは、正確な構文
-Confirm:$false
を使用して、確認プロンプトを省略できます。 - 他のほとんどのコマンドレット (たとえば、New-* や Set-* コマンドレット) には、組み込みの一時停止はありません。 これらのコマンドレットの場合、値なしで Confirm スイッチを指定すると、先に進む前に、一時停止してコマンドを確認する必要があります。
パラメーターのプロパティ
型: | SwitchParameter |
規定値: | None |
ワイルドカードのサポート: | False |
DontShow: | False |
Aliases: | cf |
パラメーター セット
(All)
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-DigestAuthentication
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
DigestAuthentication パラメーターは、仮想ディレクトリでダイジェスト認証を有効にするかどうかを指定します。 有効な値は次のとおりです。
- $true: ダイジェスト認証が有効になっています。
- $false: ダイジェスト認証が無効になっています。 この値が既定値です。
パラメーターのプロパティ
型: | Boolean |
規定値: | None |
ワイルドカードのサポート: | False |
DontShow: | False |
パラメーター セット
(All)
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-DomainController
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
DomainController パラメーターは、このコマンドレットで Active Directory からのデータの読み取りまたは Active Directory へのデータの書き込みに使用されるドメイン コントローラーを指定します。 ドメイン コントローラーは、完全修飾ドメイン名 (FQDN) で識別します。 たとえば、dc01.contoso.com です。
パラメーターのプロパティ
型: | Fqdn |
規定値: | None |
ワイルドカードのサポート: | False |
DontShow: | False |
パラメーター セット
(All)
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-ExtendedProtectionFlags
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
ExtendedProtectionFlags パラメーターは、仮想ディレクトリでの認証の拡張保護のカスタム設定を指定します。 有効な値は次のとおりです。
- [なし] : 既定の設定です。
- AllowDotlessSPN: FQDN を含まないサービス プリンシパル名 (SPN) 値 (HTTP/mail.contoso.com ではなく HTTP/ContosoMail など) を使用する場合は必須です。 SPN は ExtendedProtectionSPNList パラメーターで指定します。 この設定では、ドットレス証明書が一意ではないので、セキュリティで保護されたチャネル経由でクライアントとプロキシの接続が確立されたことを確認できないため、認証の拡張保護のセキュリティが低下します。
- NoServiceNameCheck: SPN リストは、チャネル バインド トークンを検証するためにチェックされません。 この設定により、認証の拡張保護のセキュリティが低下します。 通常、この設定はお勧めしません。
- プロキシ: プロキシ サーバーは、SSL チャネルの終了を担当します。 この設定を使用するには、ExtendedProtectionSPNList パラメーターを使用して SPN を登録する必要があります。
- ProxyCoHosting: HTTP トラフィックと HTTPS トラフィックが仮想ディレクトリにアクセスしている可能性があり、プロキシ サーバーは少なくとも一部のクライアントと Exchange サーバー上のクライアント アクセス サービスの間にあります。
パラメーターのプロパティ
型: | MultiValuedProperty |
規定値: | None |
ワイルドカードのサポート: | False |
DontShow: | False |
パラメーター セット
(All)
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-ExtendedProtectionSPNList
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
ExtendedProtectionSPNList パラメーターは、仮想ディレクトリで認証に拡張保護を使用している場合に、有効なサービス プリンシパル名 (SPN) の一覧を指定します。 有効な値は次のとおりです。
- $null: この値が既定値です。
- 有効な SPN の単一 SPN またはコンマ区切りリスト: SPN 値の形式が
Protocol\FQDN
。 たとえば、HTTP/mail.contoso.com。 FQDN ではない SPN (HTTP/ContosoMail など) を追加するには、ExtendedProtectionFlags パラメーターに AllowDotlessSPN 値も使用する必要があります。
パラメーターのプロパティ
型: | MultiValuedProperty |
規定値: | None |
ワイルドカードのサポート: | False |
DontShow: | False |
パラメーター セット
(All)
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-ExtendedProtectionTokenChecking
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
ExtendedProtectionTokenChecking パラメーターは、仮想ディレクトリで認証に拡張保護を使用する方法を定義します。 既定では、認証の拡張保護は有効になっていません。 有効な値は次のとおりです。
- なし: 認証の拡張保護は、仮想ディレクトリでは使用されません。 この値が既定値です。
- None: 認証の拡張保護は仮想ディレクトリでは使用されません。 認証の拡張保護をサポートしていないが、認証に拡張保護を使用する接続ほど安全でない可能性があるConnections。
- 必須: 認証の拡張保護は、クライアントと仮想ディレクトリ間のすべての接続に使用されます。 クライアントまたはサーバーがサポートしていない場合、接続は失敗します。 この値を使用する場合は、ExtendedProtectionSPNList パラメーターの SPN 値も設定する必要があります。
注: [許可] または [必須] の値を使用し、クライアントからプロキシへの SSL チャネルを終了するように構成されているメールボックス サーバー上のクライアントとクライアント アクセス サービスの間にプロキシ サーバーがある場合は、ExtendedProtectionSPNList パラメーターを使用して 1 つ以上のサービス プリンシパル名 (SPN) を構成する必要もあります。
パラメーターのプロパティ
型: | ExtendedProtectionTokenCheckingMode |
規定値: | None |
ワイルドカードのサポート: | False |
DontShow: | False |
パラメーター セット
(All)
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-ExternalUrl
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
ExternalURL パラメーターは、ファイアウォールの外側から仮想ディレクトリへの接続に使用される URL を指定します。
この設定は、SSL (Secure Sockets Layer) を使用する場合に重要です。
パラメーターのプロパティ
型: | Uri |
規定値: | None |
ワイルドカードのサポート: | False |
DontShow: | False |
パラメーター セット
(All)
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-Force
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
[強制] スイッチは、警告メッセージまたは確認メッセージを非表示にします。 このスイッチで値を指定する必要はありません。
管理者の入力を求めることが不適切な場合に、このスイッチを使用してタスクをプログラムによって実行することができます。
パラメーターのプロパティ
型: | SwitchParameter |
規定値: | None |
ワイルドカードのサポート: | False |
DontShow: | False |
パラメーター セット
(All)
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-GzipLevel
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
GzipLevel パラメーターは、Exchange Web Services 仮想ディレクトリの Gzip 構成を設定します。 有効な値は次のとおりです。
- オフ: 圧縮なし。
- 低: 静的圧縮のみ。 この値が既定値です。 Exchange Web Services コンテンツは動的であるため、この値の結果は Off 値と同じです。
- 高: 静的および動的な圧縮。 クライアントが要求で Gzip 圧縮のサポートを示している場合、Exchange Web サービスからのコンテンツは圧縮されます。
- エラー: Gzip 圧縮構成のエラーを識別します。
パラメーターのプロパティ
型: | GzipLevel |
規定値: | None |
ワイルドカードのサポート: | False |
DontShow: | False |
パラメーター セット
(All)
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-InternalNLBBypassUrl
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
InternalNLBBypassUrl パラメーターは、ネットワーク負荷分散 (NLB) 配列の背後にあるかどうかにかかわらず、クライアント アクセス サーバーの役割がインストールされている Exchange サーバーの URL を指定します。
InternalUrl パラメーターを NLB アレイの URL に設定する場合は、InternalNLBBypassUrl パラメーターをクライアント アクセス サーバー自体の URL に設定する必要があります。
パラメーターのプロパティ
型: | Uri |
規定値: | None |
ワイルドカードのサポート: | False |
DontShow: | False |
パラメーター セット
(All)
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-InternalUrl
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
InternalURL パラメーターは、ファイアウォールの内側から仮想ディレクトリへの接続に使用される URL を指定します。
この設定は、SSL を使用する場合に重要です。
パラメーターのプロパティ
型: | Uri |
規定値: | None |
ワイルドカードのサポート: | False |
DontShow: | False |
パラメーター セット
(All)
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-MRSProxyEnabled
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
MRSProxyEnabled パラメーターは、メールボックス サーバーに対して MRSProxy を有効にするかどうかを指定します。 MRSProxy は、リモート フォレスト内のメールボックス サーバー上で動作するサービスで、メールボックス移動のプロキシを支援します。 詳細については、「Exchange Serverでのメールボックスの移動」を参照してください。
パラメーターのプロパティ
型: | Boolean |
規定値: | None |
ワイルドカードのサポート: | False |
DontShow: | False |
パラメーター セット
(All)
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-MRSProxyMaxConnections
適用対象: Exchange Server 2010
このパラメーターは Exchange Server 2010 でのみ使用できます。
MRSProxyMaxConnections パラメーターは、MRSProxy のインスタンスが受け入れる同時移動セッションの最大数を指定します。 この設定では、0 から無制限の値を受け取ります。 既定値は 100 です。 MRSProxy の詳細については、「 移動要求について」を参照してください。
パラメーターのプロパティ
型: | Unlimited |
規定値: | None |
ワイルドカードのサポート: | False |
DontShow: | False |
パラメーター セット
(All)
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-OAuthAuthentication
適用対象: Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
OAuthAuthentication パラメーターは、仮想ディレクトリで OAuth 認証を有効にするかどうかを指定します。 有効な値は次のとおりです。
- $true: OAuth 認証が有効になっています。 この値が既定値です。
- $false: OAuth 認証が無効になっています。
パラメーターのプロパティ
型: | Boolean |
規定値: | None |
ワイルドカードのサポート: | False |
DontShow: | False |
パラメーター セット
(All)
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-Path
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
Path パラメーターは、メタベース内で仮想ディレクトリのパスを設定します。
パラメーターのプロパティ
型: | String |
規定値: | None |
ワイルドカードのサポート: | False |
DontShow: | False |
パラメーター セット
(All)
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-Role
適用対象: Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
Role パラメーターは、仮想ディレクトリの構成を指定します。 有効な値は次のとおりです。
- ClientAccess: メールボックス サーバー上のクライアント アクセス (フロントエンド) サービスの仮想ディレクトリを構成します。
- メールボックス: メールボックス サーバー上のバックエンド サービスの仮想ディレクトリを構成します。
クライアント接続は、クライアント アクセス サービスからローカルまたはリモートのメールボックス サーバー上のバックエンド サービスにプロキシされます。 クライアントは、バックエンド サービスに直接接続しません。
パラメーターのプロパティ
型: | VirtualDirectoryRole |
規定値: | None |
ワイルドカードのサポート: | False |
DontShow: | False |
パラメーター セット
(All)
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-Server
適用対象: Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
Server パラメーターは、仮想ディレクトリをホストする Exchange サーバーを指定します。 サーバーを一意に識別する任意の値を使用できます。 次に例を示します。
- 名前
- FQDN
- 識別名 (DN)
- ExchangeLegacyDN
パラメーターのプロパティ
型: | ServerIdParameter |
規定値: | None |
ワイルドカードのサポート: | False |
DontShow: | False |
パラメーター セット
(All)
配置: | Named |
必須: | False |
パイプラインからの値: | True |
プロパティ名別のパイプラインからの値: | True |
残りの引数からの値: | False |
-WebSiteName
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
WebSiteName パラメーターは、仮想ディレクトリを作成する Web サイトの名前を指定します。 このパラメーターは、既定の Web サイトの下に仮想ディレクトリを作成している場合には使用しないでください。
パラメーターのプロパティ
型: | String |
規定値: | None |
ワイルドカードのサポート: | False |
DontShow: | False |
パラメーター セット
(All)
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-WhatIf
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
WhatIf スイッチは、コマンドの操作をシミュレートします。 このスイッチを使用すると、実際にその変更内容を適用せずに、発生する変更を確認できます。 このスイッチで値を指定する必要はありません。
パラメーターのプロパティ
型: | SwitchParameter |
規定値: | None |
ワイルドカードのサポート: | False |
DontShow: | False |
Aliases: | ウィスコンシン |
パラメーター セット
(All)
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-WindowsAuthentication
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
WindowsAuthentication パラメーターは、仮想ディレクトリで統合Windows 認証を有効にするかどうかを指定します。 有効な値は次のとおりです。
- $true: 統合Windows 認証が有効になっています。 この値が既定値です。
- $false: 統合Windows 認証が無効になっています。
パラメーターのプロパティ
型: | Boolean |
規定値: | None |
ワイルドカードのサポート: | False |
DontShow: | False |
パラメーター セット
(All)
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-WSSecurityAuthentication
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
WSSecurityAuthentication パラメーターは、仮想ディレクトリで WS-Security (Web サービス セキュリティ) 認証を有効にするかどうかを指定します。 有効な値は次のとおりです。
- $true: WS-Security 認証が有効になっています。 この値が既定値です。
- $true: WS-Security 認証を有効にします。これが既定値です。
パラメーターのプロパティ
型: | Boolean |
規定値: | None |
ワイルドカードのサポート: | False |
DontShow: | False |
パラメーター セット
(All)
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
CommonParameters
このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、「about_CommonParameters」を参照してください。
入力
Input types
このコマンドレットに使用できる入力の種類を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。 コマンドレットで入力の種類のフィールドが空白の場合、そのコマンドレットには入力データを指定できません。
出力
Output types
このコマンドレットに使用できる戻り値の型 (出力の種類) を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。 出力の種類のフィールドが空白の場合、コマンドレットはデータを返しません。