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分まで実行されます)
- 「日曜日午前 1:15 〜月曜曜日 23:00」
- "月曜日午前 4:30 - 月曜日午前 5:30","水曜日午前 4:30 - 水曜日午前 5:30" (月曜日と水曜日の朝の午前 4:30 から 5:30 まで実行します)
パラメーターのプロパティ
| 型: | ScheduleInterval[] |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Identity
適用対象: Exchange Server 2010
ID パラメーターには、変更するユニファイド メッセージング サーバーを指定します。 サーバーを一意に識別する任意の値を使用できます。 次に例を示します。
- 名前
- GUID
- 識別名 (DN)
- ExchangeLegacyDN
パラメーターのプロパティ
| 型: | UMServerIdParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | 1 |
| 必須: | True |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-IrmLogEnabled
適用対象: Exchange Server 2010
IrmLogEnabled パラメーターは、Information Rights Management (IRM) トランザクションのログを有効にするかどうかを指定します。 既定で IRM ログが有効です。 値は次のとおりです。
- $true IRM ログを有効にする
- $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 = 日、h = 時間、m = 分、s = 秒。 このパラメーターの有効な入力範囲は、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 または Skype for Business ユーザーからの着信および発信通話に対して、最も近い Lync Server Edge プールまたは Skype for Business Server Edge プールの場所の FQDN ポートと TCP ポートを指定します。
複数の地理的リージョンにまたがる Lync Server または Skype for Business Server 展開では、常にこのパラメーターを使用することをお勧めします。それ以外の場合、ユニファイド メッセージング サーバーは、リモート ユーザーに地理的に最も近い Real-Time トランスポート プロトコル (RTP) メディア トラフィックのプールを選択する可能性があります。
このパラメータを各ユニファイド メッセージング サーバーに対して構成して、値が Exchange Server に最も近い 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: | wi |
パラメーター セット
(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
このコマンドレットに使用できる戻り値の型 (出力の種類) を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。 出力の種類のフィールドが空白の場合、コマンドレットはデータを返しません。