Set-UMServer
このコマンドレットは Exchange Server 2010 でのみ使用可能です。
Set-UMServer コマンドレットを使用して、ユニファイド メッセージング (UM) サーバーの役割に関連付けられている設定を変更します。
以下の構文セクションのパラメーター セットの詳細については、「Exchangeのコマンドレット構文」を参照してください。
構文
Default (既定)
Set-UMServer
[-Identity] <UMServerIdParameter>
[-Confirm]
[-DialPlans <MultiValuedProperty>]
[-DomainController <Fqdn>]
[-ExternalServiceFqdn <UMSmartHost>]
[-GrammarGenerationSchedule <ScheduleInterval[]>]
[-IrmLogEnabled <Boolean>]
[-IrmLogMaxAge <EnhancedTimeSpan>]
[-IrmLogMaxDirectorySize <Unlimited>]
[-IrmLogMaxFileSize <ByteQuantifiedSize>]
[-IrmLogPath <LocalLongFullPath>]
[-MaxCallsAllowed <Int32>]
[-SIPAccessService <ProtocolConnectionSettings>]
[-SipTcpListeningPort <Int32>]
[-SipTlsListeningPort <Int32>]
[-Status <ServerStatus>]
[-UMStartupMode <UMStartupMode>]
[-WhatIf]
[<CommonParameters>]
説明
Set-UMServer コマンドレットは、ユニファイド メッセージング サーバー上の特定のプロパティを設定します。 このコマンドレットを使用して、指定したユニファイド メッセージング サーバーの個々のユニファイド メッセージング パラメーターを設定できます。
このタスクが完了した時点で、指定したパラメーターおよび値がコマンドレットによって設定されます。
このコマンドレットを実行する際には、あらかじめアクセス許可を割り当てる必要があります。 この記事ではコマンドレットのすべてのパラメーターを一覧表示しますが、割り当てられたアクセス許可にパラメーターが含まれていない場合は、一部のパラメーターにアクセスできない可能性があります。 コマンドレットを組織内で実行するために必要になるアクセス許可とパラメーターを調べるには、「 Find the permissions required to run any Exchange cmdlet」を参照してください。
例
例 1
Set-UMServer -Identity MyUMServer -Status NoNewCalls
この例では、ユニファイド メッセージング サーバー MyUMServer が新しい呼び出しを受け入れないようにします。
例 2
Set-UMServer -Identity MyUMServer -DialPlans $null
この例では、ユニファイド メッセージング サーバー MyUMServer をすべての UM ダイヤル プランから削除します。
例 3
Set-UMServer -Identity MyUMServer -DialPlans MyUMDialPlanName -MaxCallsAllowed 50
この例では、ユニファイド メッセージング サーバー MyUMServer を UM ダイヤル プラン MyUMDialPlanName に追加し、着信音声呼び出しの最大数を 50 に設定します。
例 4
Set-UMServer -Identity MyUMServer -GrammarGenerationSchedule 0.02:30-1.03:00,1.02:30-1.03:00,2.02:30-2.03:00,3.02:30-3.03:00,4.02:30-4.03:00,5.02:30-5.03:00,6.02:30-6.03:00
次の使用例は、ユニファイド メッセージング サーバー MyUMServer で、文法生成スケジュールを毎日 02:30-03:00 に変更します。
パラメーター
-Confirm
適用対象: Exchange Server 2010
Confirm スイッチは、確認プロンプトを表示するか非表示にするかを指定します。 このスイッチがコマンドレットにどのような影響を与えるかは、先に進む前にコマンドレットで確認が必要となるかどうかで決まります。
- データを破壊するコマンドレット (たとえば、Remove- コマンドレット) には、先に進む前にユーザーにそのコマンドの確認を強制する組み込みの一時停止があります。 これらのコマンドレットでは、正確な構文
-Confirm:$falseを使用して、確認プロンプトを省略できます。 - 他のほとんどのコマンドレット (たとえば、New-* や Set-* コマンドレット) には、組み込みの一時停止はありません。 これらのコマンドレットの場合、値なしで Confirm スイッチを指定すると、先に進む前に、一時停止してコマンドを確認する必要があります。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | cf |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-DialPlans
適用対象: Exchange Server 2010
DialPlans パラメーターは、サーバーが UM 呼び出しを処理するダイヤル プランを指定します。 複数の値をコンマで区切って指定できます。
ダイヤル プランが指定されていない場合、ユニファイド メッセージング サーバーは UM 呼び出しを処理しません。
パラメーターのプロパティ
| 型: | MultiValuedProperty |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-DomainController
適用対象: Exchange Server 2010
DomainController パラメーターは、このコマンドレットで Active Directory からのデータの読み取りまたは Active Directory へのデータの書き込みに使用されるドメイン コントローラーを指定します。 ドメイン コントローラーは、完全修飾ドメイン名 (FQDN) で識別します。 たとえば、dc01.contoso.com です。
パラメーターのプロパティ
| 型: | Fqdn |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-ExternalServiceFqdn
適用対象: Exchange Server 2010
ExternalServiceFqdn パラメーターは、ユニファイド メッセージング サーバーをサービスするロード バランサーの FQDN またはホスト名です。 このパラメーターは、organization内から Microsoft Exchange Server 2010 ホスト環境にユニファイド メッセージング サーバーを移行する場合に便利です。 外部サービス ホスト FQDN には、最大 2,048 文字を含めることができます。
パラメーターのプロパティ
| 型: | UMSmartHost |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-GrammarGenerationSchedule
適用対象: Exchange Server 2010
GrammarGenerationSchedule パラメーターは、音声文法の生成を開始するためのスケジュールされた時刻を指定します。 このパラメーターでは、1 日に 1 回の開始時刻のみを使用できます。 文法生成の既定のスケジュールされた時刻は、毎日 02:00-02:30 現地時間です。
このパラメーターの構文は、 StartDay.Hour:Minute [AM | PM]-EndDay.Hour:Minute [AM | PM]です。 複数のスケジュールをコンマで区切って指定できます: "Schedule1","Schedule2",..."ScheduleN"。
日数は次の値を使用できます。
- その日のフル ネーム。
- 日付の省略名。
- 0 から 6 までの整数 。0 = 日曜日。
時刻を 24 時間形式で入力し、AM/PM 値を省略できます。 時刻を 12 時間形式で入力する場合は、時刻と AM/PM 値の間にスペースを含めます。
日付/時刻形式を混在させ、一致させることができます。
開始時刻と終了時刻は 15 分以上離れている必要があります。 分は 0、15、30、または 45 に切り捨てられます。 複数の時間帯を指定する場合は、各時間帯を 15 分以上離す必要があります。
次に、いくつかの例を示します:
- "Sun.11:30 PM-Mon.1:30 AM"
- "6.22:00-6.22:15" (土曜日の午後 10:00 から土曜日の午後 10:15 まで実行されます。
- "Sun.1:15 AM-Monday.23:00"
- "Monday.4:30 AM-Monday.5:30 AM","Wednesday.4:30 AM-Wednesday.5:30 AM" (月曜日と水曜日の午前 4:30 から 5:30 まで実行されます。
パラメーターのプロパティ
| 型: | ScheduleInterval[] |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Identity
適用対象: Exchange Server 2010
Identity パラメーターは、変更するユニファイド メッセージング サーバーを指定します。 サーバーを一意に識別する任意の値を使用できます。 次に例を示します。
- 名前
- GUID
- 識別名 (DN)
- ExchangeLegacyDN
パラメーターのプロパティ
| 型: | UMServerIdParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | 1 |
| 必須: | True |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-IrmLogEnabled
適用対象: Exchange Server 2010
IrmLogEnabled パラメーターは、Information Rights Management (IRM) トランザクションのログ記録を有効にするかどうかを指定します。 既定で IRM ログが有効です。 値は次のとおりです。
- IRM ログを有効にする$true
- $false IRM ログを無効にする
パラメーターのプロパティ
| 型: | Boolean |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-IrmLogMaxAge
適用対象: Exchange Server 2010
IrmLogMaxAge パラメーターには、IRM ログ ファイルの最大保存期間を指定します。 指定した値より古いログ ファイルは削除されます。 既定値は 30 日です。 値を指定するには、dd.hh:mm:ss という期間として値を入力します。ここで、d = days、h = hours、m = minutes、s = seconds です。 このパラメーターの有効な入力範囲は、00:00:00 ~ 24855.03:14:07 です。 IrmLogMaxAge パラメーターの値を 00:00:00 に設定すると、有効期間が原因で IRM ログ ファイルが自動的に削除されるのを防ぐことができます。
パラメーターのプロパティ
| 型: | EnhancedTimeSpan |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-IrmLogMaxDirectorySize
適用対象: Exchange Server 2010
IrmLogMaxDirectorySize パラメーターは、接続ログ ディレクトリ内のすべての IRM ログの最大サイズを指定します。 ディレクトリが最大ファイル サイズに到達すると、最も古いログ ファイルから削除されます。 既定値は 250 MB です。 値を入力するときは、値に以下の単位のいずれかを付加した形式で記述します。
- B (バイト)
- KB (キロバイト)
- MB (メガバイト)
- GB (ギガバイト)
- TB (テラバイト)
単位が付加されていない値は、バイトとして扱われます。 IrmLogMaxFileSize パラメーターの値は、IrmLogMaxDirectorySize パラメーターの値以下である必要があります。 각 매개 변수에는 1바이트에서 9223372036854775807바이트까지의 값을 입력할 수 있습니다. 無制限の値を入力すると、接続ログ ディレクトリにサイズ制限は適用されません。
パラメーターのプロパティ
| 型: | Unlimited |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-IrmLogMaxFileSize
適用対象: Exchange Server 2010
IrmLogMaxFileSize パラメーターは、各 IRM ログ ファイルの最大サイズを指定します。 ログ ファイルが最大サイズに達すると、新しいログ ファイルが作成されます。 既定値は 10 MB です。 値を入力するときは、値に以下の単位のいずれかを付加した形式で記述します。
- B (バイト)
- KB (キロバイト)
- MB (メガバイト)
- GB (ギガバイト)
- TB (テラバイト)
単位が付加されていない値は、バイトとして扱われます。 IrmLogMaxFileSize パラメーターの値は、IrmLogMaxDirectorySize パラメーターの値以下である必要があります。 각 매개 변수에는 1바이트에서 9223372036854775807바이트까지의 값을 입력할 수 있습니다. 無制限の値を入力すると、IRM ログ ファイルにサイズ制限は適用されません。
パラメーターのプロパティ
| 型: | ByteQuantifiedSize |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-IrmLogPath
適用対象: Exchange Server 2010
IrmLogPath パラメーターには、既定の IRM ログ ディレクトリの場所を指定します。 既定値は %ExchangeInstallPath%IRMLogs です。
このパラメーターの値を $null に設定すると、IRM ログを効果的に無効にします。 ただし、IrmLogEnabled パラメーターの値が$trueされている場合、Exchange はアプリケーション イベント ログにエラーを追加します。 IRM ログを無効にする推奨される方法は、IrmLogEnabled パラメーターを $false に設定することです。
パラメーターのプロパティ
| 型: | LocalLongFullPath |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-MaxCallsAllowed
適用対象: Exchange Server 2010
MaxCallsAllowed パラメーターは、ユニファイド メッセージング サーバーで許可される同時音声呼び出しの最大数を指定します。
パラメーターのプロパティ
| 型: | Int32 |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-SIPAccessService
適用対象: Exchange Server 2010
SIPAccessService パラメーターは、最も近い Lync Server Edge プールの FQDN と TCP ポート、またはネットワークの外部にあるリモート Lync または Skype for Business ユーザーからの着信および送信呼び出し用の Skype for Business Server Edge プールの場所を指定します。
Lync Server または複数の地理的リージョンにまたがるSkype for Business Server展開では、常にこのパラメーターを使用することをお勧めします。それ以外の場合、ユニファイド メッセージング サーバーは、リモート ユーザーに地理的に最も近くない Real-Time トランスポート プロトコル (RTP) メディア トラフィック用のプールを選択する場合があります。
各ユニファイド メッセージング サーバーに対してこのパラメーターを構成すると、値によって Exchange サーバーに最も近い Lync Server Edge プールまたは Skype for Business Server Edge プールが識別されます。
パラメーターのプロパティ
| 型: | ProtocolConnectionSettings |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-SipTcpListeningPort
適用対象: Exchange Server 2010
SipTcpListeningPort パラメーターは、ユニファイド メッセージング サーバーが着信呼び出しを受信するために使用する TCP ポートを指定します。 この TCP ポートは、SIP セキュリティ保護モードまたはセキュリティ保護モードを使用するように構成されていない UM ダイヤル プランに追加されたユニファイド メッセージング サーバーによって使用されます。 既定のポートは 5060 です。
パラメーターのプロパティ
| 型: | Int32 |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-SipTlsListeningPort
適用対象: Exchange Server 2010
SipTlsListeningPort パラメーターは、ユニファイド メッセージング サーバーが着信呼び出しを受信するために使用するトランスポート層セキュリティ (TLS) ポートを指定します。 この TLS ポートは、SIP セキュリティ保護モードまたはセキュリティ保護モードを使用するように構成された UM ダイヤル プランに追加されるユニファイド メッセージング サーバーによって使用されます。 既定のポートは 5061 です。
パラメーターのプロパティ
| 型: | Int32 |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Status
適用対象: Exchange Server 2010
Status パラメーターは、ユニファイド メッセージング サーバーの状態を指定します。 使用可能なオプションは、有効、無効、および NoNewCalls です。
パラメーターのプロパティ
| 型: | ServerStatus |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-UMStartupMode
適用対象: Exchange Server 2010
UMStartupMode パラメーターは、Exchange サーバー上の Microsoft Exchange ユニファイド メッセージング サービスのスタートアップ モードを指定します。 有効な値は次のとおりです。
- TCP
- TLS
- デュアル: この値を使用して、さまざまなセキュリティ設定でユニファイド メッセージング サーバーを UM ダイヤル プランに追加します。 ユニファイド メッセージング サーバーは、ポート 5060 と 5061 で同時にリッスンできます。
スタートアップ モードを変更する場合は、Microsoft Exchange ユニファイド メッセージング サービスを再起動する必要があります。
パラメーターのプロパティ
| 型: | UMStartupMode |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-WhatIf
適用対象: Exchange Server 2010
WhatIf スイッチは、コマンドの操作をシミュレートします。 このスイッチを使用すると、実際にその変更内容を適用せずに、発生する変更を確認できます。 このスイッチで値を指定する必要はありません。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | ウィスコンシン |
パラメーター セット
(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
このコマンドレットに使用できる戻り値の型 (出力の種類) を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。 出力の種類のフィールドが空白の場合、コマンドレットはデータを返しません。