Set-UMService

リファレンス

モジュール:: ExchangePowerShell

適用対象:: Exchange Server 2013, Exchange Server 2016

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

Set-UMService コマンドレットを使用して、Exchange 2013 または Exchange 2016 メールボックスサーバー上の exchange ユニファイドメッセージングサービスMicrosoftのプロパティを変更します。

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

構文

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 に設定します。
northamerica.lyncpoolna.contoso.com:5061 Lync Server で使用される SIP アクセスサービスの FQDN とポート、またはリモート Lync または Microsoft Skype for Business クライアントからの受信および送信呼び出しにSkype for Business Serverを設定します。
メールボックスサーバー MyUMServer Microsoft Exchange ユニファイドメッセージングサービスを TLS モードで起動できるようにします。

パラメーター

-Confirm

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

破壊的なコマンドレット (Remove-* コマンドレットなど) には、続行する前にコマンドの確認を強制する組み込みの一時停止があります。これらのコマンドレットでは、正確な構文-Confirm:$falseを使用して、確認プロンプトを省略できます。
他のほとんどのコマンドレット (New-* コマンドレットや Set-* コマンドレットなど) には、一時停止が組み込まれています。これらのコマンドレットの場合、値なしで Confirm スイッチを指定すると、先に進む前に、一時停止してコマンドを確認する必要があります。

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2013, Exchange Server 2016

-DialPlans

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"...}

Type:	MultiValuedProperty
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2013, Exchange Server 2016

-DomainController

DomainController パラメーターは、このコマンドレットで Active Directory からのデータの読み取りまたは Active Directory へのデータの書き込みに使用されるドメインコントローラーを指定します。ドメインコントローラーは、完全修飾ドメイン名 (FQDN) で識別します。たとえば、dc01.contoso.com です。

Type:	Fqdn
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2013, Exchange Server 2016

-GrammarGenerationSchedule

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 まで実行されます。

Type:	ScheduleInterval[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2013, Exchange Server 2016

-Identity

Identity パラメーターは、変更するユニファイドメッセージングサービス構成をホストするメールボックスサーバーを指定します。サーバーを一意に識別する任意の値を使用できます。次に例を示します。

名前
識別名 (DN)
ExchangeLegacyDN
GUID

Type:	UMServerIdParameter
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Exchange Server 2013, Exchange Server 2016

-IPAddressFamily

IPAddressFamily パラメーターは、UM IP ゲートウェイが IPv4、IPv6、またはその両方を使用して通信するかどうかを指定します。有効な値は次のとおりです。

IPv4
IPv6
Any: IPv6 が最初に使用され、必要に応じて UM IP ゲートウェイが IPv4 にフォールバックします。これは既定の値です。

Type:	IPAddressFamily
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2013, Exchange Server 2016

-IPAddressFamilyConfigurable

IPAddressFamilyConfigurable パラメーターは、IPAddressFamily パラメーターを IPv6Only または Any に設定できるかどうかを指定します。既定値は $true です。

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2013, Exchange Server 2016

-IrmLogEnabled

IrmLogEnabled パラメーターは、Information Rights Management (IRM) トランザクションのログ記録を有効にするかどうかを指定します。既定で IRM ログが有効です。有効な値は次のとおりです。

$true: IRM ログを有効にする
$false: IRM ログを無効にする

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2013, Exchange Server 2016

-IrmLogMaxAge

IrmLogMaxAge パラメーターには、IRM ログファイルの最大保存期間を指定します。指定した値より古いログファイルは削除されます。既定値は 30 日です。

値を指定するには、dd.hh:mm:ss の形式で期間として入力します。ここで、dd = 日、hh = 時間、mm = 分、ss = 秒です。

このパラメーターの有効な入力範囲は、00:00:00 ～ 24855.03:14:07 です。 IrmLogMaxAge パラメーターの値を 00:00:00 に設定すると、有効期間が原因で IRM ログファイルが自動的に削除されるのを防ぐことができます。

Type:	EnhancedTimeSpan
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2013, Exchange Server 2016

-IrmLogMaxDirectorySize

IrmLogMaxDirectorySize パラメーターは、接続ログディレクトリ内のすべての IRM ログの最大サイズを指定します。ディレクトリが最大ファイルサイズに到達すると、最も古いログファイルから削除されます。既定値は 250 MB です。

値を入力するときは、値に以下の単位のいずれかを付加した形式で記述します。

B (バイト)
KB (キロバイト)
MB (メガバイト)
GB (ギガバイト)
TB (テラバイト)

通常、単位なしの値はバイトとして扱われますが、小さい値は最も近いキロバイトの値に切り上げられます。

IrmLogMaxFileSize パラメーターの値は、IrmLogMaxDirectorySize パラメーターの値以下である必要があります。 각 매개 변수에는 1바이트에서 9223372036854775807바이트까지의 값을 입력할 수 있습니다. 無制限の値を入力すると、接続ログディレクトリにサイズ制限は適用されません。

Type:	Unlimited
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2013, Exchange Server 2016

-IrmLogMaxFileSize

IrmLogMaxFileSize パラメーターは、各 IRM ログファイルの最大サイズを指定します。ログファイルが最大サイズに達すると、新しいログファイルが作成されます。既定値は 10 MB です。

値を入力するときは、値に以下の単位のいずれかを付加した形式で記述します。

B (バイト)
KB (キロバイト)
MB (メガバイト)
GB (ギガバイト)
TB (テラバイト)

通常、単位なしの値はバイトとして扱われますが、小さい値は最も近いキロバイトの値に切り上げられます。

IrmLogMaxFileSize パラメーターの値は、IrmLogMaxDirectorySize パラメーターの値以下である必要があります。 각 매개 변수에는 1바이트에서 9223372036854775807바이트까지의 값을 입력할 수 있습니다. 無制限の値を入力すると、IRM ログファイルにサイズ制限は適用されません。

Type:	ByteQuantifiedSize
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2013, Exchange Server 2016

-IrmLogPath

IrmLogPath パラメーターには、既定の IRM ログディレクトリの場所を指定します。既定の場所は %ExchangeInstallPath%IRMLogs です。

このパラメーターの値を $null に設定すると、IRM ログを効果的に無効にできます。ただし、このパラメーターを $nullに設定すると、IrmLogEnabled パラメーターの値が$trueされると、アプリケーションイベントログにエラーが生成されます。 IRM ログを無効にする推奨される方法は、IrmLogEnabled パラメーターを $false に設定することです。

Type:	LocalLongFullPath
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2013, Exchange Server 2016

-MaxCallsAllowed

MaxCallsAllowed パラメーターは、ユニファイドメッセージングサービスで許可される同時音声呼び出しの最大数を指定します。既定値は 100 です。

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2013, Exchange Server 2016

-SIPAccessService

SIPAccessService パラメーターは、最も近い Lync Server フロントエンドプールの FQDN と TCP ポート、またはリモート Lync またはネットワークの外部にある Skype for Business ユーザーからの受信および送信呼び出しのフロントエンドプールの場所Skype for Business Server指定します。

Lync Server または複数の地理的リージョンにまたがるSkype for Business Server展開では、常にこのパラメーターを使用することをお勧めします。それ以外の場合は、Microsoft Exchange ユニファイドメッセージングサービスによって、リモートユーザーに地理的に最も近くないReal-Timeトランスポートプロトコル (RTP) メディアトラフィック用のプールが選択される場合があります。

ユニファイドメッセージングサービス (各 Exchange サーバー) の各インスタンスに対してこのパラメーターを構成して、値が Exchange サーバーに最も近い Lync Server フロントエンドプールまたは Skype for Business Server フロントエンドプールを識別するようにします。

Type:	ProtocolConnectionSettings
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2013, Exchange Server 2016

-Status

このパラメーターは非推奨で、もう使用されていません。

Type:	ServerStatus
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2013, Exchange Server 2016

-UMStartupMode

UMStartupMode パラメーターは、ユニファイドメッセージングサービスのスタートアップモードを指定します。有効な値は次のとおりです。

TCP (既定値です)
TLS
デュアル: サービスは、ポート 5060 と 5061 で同時にリッスンできます。セキュリティ設定が異なる UM ダイヤルプランに Exchange サーバーを追加する場合は、この値を使用する必要があります。

このパラメーターの値を変更する場合は、ユニファイドメッセージングサービスを再起動する必要があります。

Type:	UMStartupMode
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2013, Exchange Server 2016

-WhatIf

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

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2013, Exchange Server 2016

入力

Input types

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

出力

Output types

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