Set-UMService
このコマンドレットは、オンプレミスの Exchange でのみ使用可能です。
Set-UMService コマンドレットを使用して、Exchange 2013 または Exchange 2016 メールボックス サーバー上の Microsoft Exchange ユニファイド メッセージング サービスのプロパティを変更します。
以下の構文セクションのパラメーター セットの詳細については、「Exchangeのコマンドレット構文」を参照してください。
構文
Default (既定)
Set-UMService
[-Identity] <UMServerIdParameter>
[-Confirm]
[-DialPlans <MultiValuedProperty>]
[-DomainController <Fqdn>]
[-GrammarGenerationSchedule <ScheduleInterval[]>]
[-IPAddressFamily <IPAddressFamily>]
[-IPAddressFamilyConfigurable <Boolean>]
[-IrmLogEnabled <Boolean>]
[-IrmLogMaxAge <EnhancedTimeSpan>]
[-IrmLogMaxDirectorySize <Unlimited>]
[-IrmLogMaxFileSize <ByteQuantifiedSize>]
[-IrmLogPath <LocalLongFullPath>]
[-MaxCallsAllowed <Int32>]
[-SIPAccessService <ProtocolConnectionSettings>]
[-Status <ServerStatus>]
[-UMStartupMode <UMStartupMode>]
[-WhatIf]
[<CommonParameters>]
説明
このコマンドレットを実行する際には、あらかじめアクセス許可を割り当てる必要があります。 この記事にはこのコマンドレットのすべてのパラメーターが一覧表示されていますが、自分に割り当てられているアクセス許可に含まれていない一部のパラメーターにはアクセスできません。 コマンドレットを組織内で実行するために必要になるアクセス許可とパラメーターを調べるには、「 Find the permissions required to run any Exchange cmdlet」を参照してください。
例
例 1
Set-UMService -Identity MyUMServer -IPAddressFamily Any -UMStartupMode Dual
この例は以下のアクションを実行します。
- メールボックス サーバー MyUMServer 上の Microsoft Exchange ユニファイド メッセージング サービスを有効にして、IPv4 と IPv6 の両方のデータ パケットを受け入れます。
- メールボックス サーバー MyUMServer 上の Microsoft Exchange ユニファイド メッセージング サービスを有効にして、TCP モードと TLS モードの両方を使用して起動できるようにします。
例 2
Set-UMService -Identity MyUMServer -DialPlans $null
この例では、すべての UM ダイヤル プランからメールボックス サーバー MyUMServer を削除します。
例 3
Set-UMService -Identity MyUMServer -DialPlans MySIPDialPlan -MaxCallsAllowed 50 -SipAccessService northamerica.lyncpoolna.contoso.com:5061 -UMStartupMode TLS
この例は以下のアクションを実行します。
- メールボックス サーバー MyUMServer を UM ダイヤル プラン MySIPDialPlan に追加します。
- 着信呼び出しの最大数を 50 に設定します。
- リモート Lync または Skype for Business クライアントからの着信および発信通話に Microsoft Lync Server または Skype for Business Server によって使用される SIP アクセス サービスの FQDN およびポートとして northamerica.lyncpoolna.contoso.com:5061 を設定します。
- メールボックス サーバー MyUMServer 上の Microsoft Exchange ユニファイド メッセージング サービスを TLS モードで起動できるようにします。
パラメーター
-Confirm
適用対象: Exchange Server 2013、Exchange Server 2016
Confirm スイッチは、確認プロンプトを表示するか非表示にするかを指定します。 このスイッチがコマンドレットに与える影響は、コマンドレットが続行する前に確認を必要とするかどうかによって異なります。
- データを破壊するコマンドレット (たとえば、Remove- コマンドレット) には、先に進む前にユーザーにそのコマンドの確認を強制する組み込みの一時停止があります。 これらのコマンドレットでは、正確な構文
-Confirm:$falseを使用して、確認プロンプトを省略できます。 - 他のほとんどのコマンドレット (たとえば、New-* や Set-* コマンドレット) には、組み込みの一時停止はありません。 これらのコマンドレットの場合、値を指定せずに Confirm スイッチを指定すると、一時停止が発生し、続行する前にコマンドの確認を強制されます。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | Cf |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-DialPlans
適用対象: Exchange Server 2013、Exchange Server 2016
DialPlans パラメータは、ユニファイド メッセージング サービスが着信呼び出しを処理するすべてのダイヤル プランを指定します。
Exchange 2016 サーバーおよび Exchange 2013 サーバーは、TelExt または E.164 UM ダイヤル プランに関連付けることはできませんが、SIP ダイヤル プランに関連付けまたは追加することはできます。 ユニファイド メッセージングを Lync Server 2010、Lync Server 2013、または Skype for Business Server 2015 と統合する場合は、すべての Exchange 2016 サーバーと Exchange 2013 サーバーを SIP ダイヤル プランに関連付けまたは追加する必要があります。
このパラメータを使用して、Exchange 2010 ユニファイド メッセージング サーバーを UM ダイヤル プランに関連付けることもできます。
複数の値を入力して既存のエントリをすべて上書きするには、次の構文を使用します: Value1,Value2,...ValueN。 値にスペースを含める、または引用符を必要とする場合は、次の構文を使用します: "Value1","Value2",..."ValueN"。
既存のエントリに影響を及ぼさずに、1 つまたは複数の値を追加または削除するには、次の構文を使用します: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}。
パラメーターのプロパティ
| 型: | MultiValuedProperty |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-DomainController
適用対象: Exchange Server 2013、Exchange Server 2016
DomainController パラメーターは、このコマンドレットで Active Directory からのデータの読み取りまたは Active Directory へのデータの書き込みに使用されるドメイン コントローラーを指定します。 ドメイン コントローラーは、完全修飾ドメイン名 (FQDN) で識別します。 たとえば、dc01.contoso.com です。
パラメーターのプロパティ
| 型: | Fqdn |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-GrammarGenerationSchedule
適用対象: Exchange Server 2013、Exchange Server 2016
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 2013、Exchange Server 2016
Identity パラメーターは、変更するユニファイド メッセージング サービスの構成をホストするメールボックス サーバーを指定します。 サーバーを一意に識別する任意の値を使用できます。 次に例を示します。
- 名前
- 識別名 (DN)
- ExchangeLegacyDN
- GUID
パラメーターのプロパティ
| 型: | UMServerIdParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | 1 |
| 必須: | True |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-IPAddressFamily
適用対象: Exchange Server 2013、Exchange Server 2016
IPAddressFamily パラメーターは、使用するインターネット プロトコル (IP) のバージョンを指定します。 有効な値は次のとおりです。
- IPv4Only: UM IP ゲートウェイは、IPv4 のみを使用して通信します。
- IPv6Only: UM IP ゲートウェイは IPv6 のみを使用します。
- 任意: IPv6 が最初に使用されます。 IPv6 が利用できない場合は、IPv4 が使用されます。 この値が既定値です。
パラメーターのプロパティ
| 型: | IPAddressFamily |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-IPAddressFamilyConfigurable
適用対象: Exchange Server 2013、Exchange Server 2016
IPAddressFamilyConfigurable パラメーターは、IPAddressFamily パラメーターを IPv6Only または Any に設定できるかどうかを指定します。 既定値は $true です。
パラメーターのプロパティ
| 型: | Boolean |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-IrmLogEnabled
適用対象: Exchange Server 2013、Exchange Server 2016
IrmLogEnabled パラメーターは、Information Rights Management (IRM) トランザクションのログを有効にするかどうかを指定します。 既定で IRM ログが有効です。 有効な値は次のとおりです。
- $true: IRM ログを有効にする
- $false: IRM ログを無効にする
パラメーターのプロパティ
| 型: | Boolean |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-IrmLogMaxAge
適用対象: Exchange Server 2013、Exchange Server 2016
IrmLogMaxAge パラメーターには、IRM ログ ファイルの最大保存期間を指定します。 指定した値より古いログ ファイルは削除されます。 既定値は 30 日です。
値を指定するには、dd.hh:mm:ss の形式で期間として入力します。ここで、dd = 日、hh = 時間、mm = 分、ss = 秒です。
このパラメーターの有効な入力範囲は、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 2013、Exchange Server 2016
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 2013、Exchange Server 2016
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 2013、Exchange Server 2016
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 2013、Exchange Server 2016
MaxCallsAllowed パラメーターは、ユニファイド メッセージング サービスが許可する同時音声通話の最大数を指定します。 既定値は 100 です。
パラメーターのプロパティ
| 型: | Int32 |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-SIPAccessService
適用対象: Exchange Server 2013、Exchange Server 2016
SIPAccessService パラメーターは、ネットワーク外にあるリモート Lync または Skype for Business ユーザーからの着信および発信通話用の、最も近い Lync Server フロント エンド プールまたは Skype for Business Server フロントエンド プールの場所の FQDN および TCP ポートを指定します。
複数の地理的地域にまたがる Lync Server または Skype for Business Server 展開では、常にこのパラメータを使用することをお勧めします。それ以外の場合、Microsoft Exchange ユニファイド メッセージング サービスは、リモート ユーザーに地理的に最も近い Real-Time トランスポート プロトコル (RTP) メディア トラフィックのプールを選択する可能性があります。
このパラメータは、ユニファイド メッセージング サービスの各インスタンス (各 Exchange サーバー) に対して構成して、値が Exchange サーバーに最も近い Lync Server フロントエンド プールまたは Skype for Business Server フロントエンド プールを識別するようにします。
パラメーターのプロパティ
| 型: | ProtocolConnectionSettings |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Status
適用対象: Exchange Server 2013、Exchange Server 2016
このパラメーターは非推奨となり、使用されなくなりました。
パラメーターのプロパティ
| 型: | ServerStatus |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-UMStartupMode
適用対象: Exchange Server 2013、Exchange Server 2016
UMStartupMode パラメーターは、ユニファイド メッセージング サービスのスタートアップ モードを指定します。 有効な値は次のとおりです。
- TCP (既定値)
- TLS
- デュアル: サービスはポート 5060 と 5061 で同時にリッスンできます。 セキュリティ設定が異なる UM ダイヤル プランに Exchange サーバーを追加する場合は、この値を使用する必要があります。
このパラメーターの値を変更すると、ユニファイド メッセージング サービスを再起動する必要があります。
パラメーターのプロパティ
| 型: | UMStartupMode |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-WhatIf
適用対象: Exchange Server 2013、Exchange Server 2016
[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
このコマンドレットに使用できる戻り値の型 (出力の種類) を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。 出力の種類のフィールドが空白の場合、コマンドレットはデータを返しません。