次の方法で共有

New-WebServicesVirtualDirectory

モジュール:
ExchangePowerShell
適用対象:
Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

このコマンドレットは、オンプレミスの Exchange でのみ使用可能です。

New-WebServicesVirtualDirectory コマンドレットを使用して、Microsoft Exchange サーバー上のインターネット インフォメーション サービス (IIS) で使用される Exchange Web サービス仮想ディレクトリを作成します。

このコマンドレットでは、複数の仮想ディレクトリを作成できます。 ただし、Web サイトごとに作成できる Exchange Web サービス仮想ディレクトリは 1 つだけです。

以下の構文セクションのパラメーター セットの詳細については、「Exchangeのコマンドレット構文」を参照してください。

構文

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
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-AppPoolId

適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019

AppPoolId パラメーターは、仮想ディレクトリが機能する IIS アプリケーション プールを指定します。 このパラメーターを既定の設定のままにすることをお勧めします。

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-AppPoolIdForManagement

適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019

AppPoolIdForManagement パラメーターには、仮想ディレクトリを管理するプログラム プールを指定します。

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-BasicAuthentication

適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019

BasicAuthentication パラメーターは、仮想ディレクトリで基本認証を有効にするかどうかを指定します。 有効な値は次のとおりです。

  • $true: 基本認証が有効になっています。 これは既定の値です。
  • $true: 基本認証を有効にします。これが既定値です。
型:Boolean
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Confirm

適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019

Confirm スイッチは、確認プロンプトを表示するか非表示にするかを指定します。 このスイッチがコマンドレットにどのような影響を与えるかは、先に進む前にコマンドレットで確認が必要となるかどうかで決まります。

  • データを破壊するコマンドレット (たとえば、Remove- コマンドレット) には、先に進む前にユーザーにそのコマンドの確認を強制する組み込みの一時停止があります。 これらのコマンドレットでは、正確な構文-Confirm:$falseを使用して、確認プロンプトを省略できます。
  • 他のほとんどのコマンドレット (たとえば、New-* や Set-* コマンドレット) には、組み込みの一時停止はありません。 これらのコマンドレットの場合、値なしで Confirm スイッチを指定すると、先に進む前に、一時停止してコマンドを確認する必要があります。
型:SwitchParameter
Aliases:cf
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-DigestAuthentication

適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019

DigestAuthentication パラメーターは、仮想ディレクトリでダイジェスト認証を有効にするかどうかを指定します。 有効な値は次のとおりです。

  • $true: ダイジェスト認証が有効になっています。
  • $false: ダイジェスト認証が無効になっています。 これは既定の値です。
型:Boolean
配置:Named
規定値:None
必須: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
配置:Named
規定値:None
必須: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
配置:Named
規定値:None
必須: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
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ExtendedProtectionTokenChecking

適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019

ExtendedProtectionTokenChecking パラメーターは、仮想ディレクトリで認証に拡張保護を使用する方法を定義します。 既定では、認証の拡張保護は有効になっていません。 有効な値は次のとおりです。

  • なし: 認証の拡張保護は、仮想ディレクトリでは使用されません。 これは既定の値です。
  • None: 認証の拡張保護は仮想ディレクトリでは使用されません。 これが既定値です。
  • 必須: 認証の拡張保護は、クライアントと仮想ディレクトリ間のすべての接続に使用されます。 クライアントまたはサーバーがサポートしていない場合、接続は失敗します。 この値を使用する場合は、ExtendedProtectionSPNList パラメーターの SPN 値も設定する必要があります。

注: [許可] または [必須] の値を使用し、クライアントからプロキシへの SSL チャネルを終了するように構成されているメールボックス サーバー上のクライアントとクライアント アクセス サービスの間にプロキシ サーバーがある場合は、ExtendedProtectionSPNList パラメーターを使用して 1 つ以上のサービス プリンシパル名 (SPN) を構成する必要もあります。

型:ExtendedProtectionTokenCheckingMode
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ExternalUrl

適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019

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

この設定は、SSL (Secure Sockets Layer) を使用する場合に重要です。

型:Uri
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Force

適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019

[強制] スイッチは、警告メッセージまたは確認メッセージを非表示にします。 このスイッチで値を指定する必要はありません。

管理者の入力を求めることが不適切な場合に、このスイッチを使用してタスクをプログラムによって実行することができます。

型:SwitchParameter
配置:Named
規定値:None
必須: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
配置:Named
規定値:None
必須: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
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-InternalUrl

適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019

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

この設定は、SSL を使用する場合に重要です。

型:Uri
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-MRSProxyEnabled

適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019

MRSProxyEnabled パラメーターは、メールボックス サーバーに対して MRSProxy を有効にするかどうかを指定します。 MRSProxy は、リモート フォレスト内のメールボックス サーバー上で動作するサービスで、メールボックス移動のプロキシを支援します。 詳細については、「Exchange Serverでのメールボックスの移動」を参照してください。

型:Boolean
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-MRSProxyMaxConnections

適用対象: Exchange Server 2010

このパラメーターは Exchange Server 2010 でのみ使用できます。

MRSProxyMaxConnections パラメーターは、MRSProxy のインスタンスが受け入れる同時移動セッションの最大数を指定します。 この設定では、0 から無制限の値を受け取ります。 既定値は 100 です。 MRSProxy の詳細については、「 移動要求について」を参照してください。

型:Unlimited
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-OAuthAuthentication

適用対象: Exchange Server 2013、Exchange Server 2016、Exchange Server 2019

OAuthAuthentication パラメーターは、仮想ディレクトリで OAuth 認証を有効にするかどうかを指定します。 有効な値は次のとおりです。

  • $true: OAuth 認証が有効になっています。 これは既定の値です。
  • $false: OAuth 認証が無効になっています。
型:Boolean
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Path

適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019

Path パラメーターは、メタベース内で仮想ディレクトリのパスを設定します。

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Role

適用対象: Exchange Server 2013、Exchange Server 2016、Exchange Server 2019

Role パラメーターは、仮想ディレクトリの構成を指定します。 有効な値は次のとおりです。

  • ClientAccess: メールボックス サーバー上のクライアント アクセス (フロントエンド) サービスの仮想ディレクトリを構成します。
  • メールボックス: メールボックス サーバー上のバックエンド サービスの仮想ディレクトリを構成します。

クライアント接続は、クライアント アクセス サービスからローカルまたはリモートのメールボックス サーバー上のバックエンド サービスにプロキシされます。 クライアントは、バックエンド サービスに直接接続しません。

型:VirtualDirectoryRole
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Server

適用対象: Exchange Server 2013、Exchange Server 2016、Exchange Server 2019

Server パラメーターは、仮想ディレクトリをホストする Exchange サーバーを指定します。 サーバーを一意に識別する任意の値を使用できます。 次に例を示します。

  • 名前
  • FQDN
  • 識別名 (DN)
  • ExchangeLegacyDN
型:ServerIdParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-WebSiteName

適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019

WebSiteName パラメーターは、仮想ディレクトリを作成する Web サイトの名前を指定します。 このパラメーターは、既定の Web サイトの下に仮想ディレクトリを作成している場合には使用しないでください。

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-WhatIf

適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019

WhatIf スイッチは、コマンドの操作をシミュレートします。 このスイッチを使用すると、実際にその変更内容を適用せずに、発生する変更を確認できます。 このスイッチで値を指定する必要はありません。

型:SwitchParameter
Aliases:wi
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-WindowsAuthentication

適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019

WindowsAuthentication パラメーターは、仮想ディレクトリで統合Windows 認証を有効にするかどうかを指定します。 有効な値は次のとおりです。

  • $true: 統合Windows 認証が有効になっています。 これは既定の値です。
  • $false: 統合Windows 認証が無効になっています。
型:Boolean
配置:Named
規定値:None
必須: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
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

入力

Input types

このコマンドレットに使用できる入力の種類を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。 コマンドレットで入力の種類のフィールドが空白の場合、そのコマンドレットには入力データを指定できません。

出力

Output types

このコマンドレットに使用できる戻り値の型 (出力の種類) を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。 出力の種類のフィールドが空白の場合、コマンドレットはデータを返しません。