Set-CsRegistrar

構文

Set-CsRegistrar [-Identity <XdsGlobalRelativeIdentity>] [-ArchivingServer <String>] [-BackupRegistrar <String>] [-Confirm [<SwitchParameter>]] [-EdgeServer <String>] [-EnableAutomaticFailover <$true | $false>] [-FailbackDetectionInterval <TimeSpan>] [-FailureDetectionInterval <TimeSpan>] [-Force <SwitchParameter>] [-MonitoringServer <String>] [-Registrar <String>] [-SipHealthPort <UInt16>] [-SipPort <UInt16>] [-SipServerTcpPort <UInt16>] [-UserServer <String>] [-WebPort <UInt16>] [-WebServer <String>] [-WhatIf [<SwitchParameter>]]

解説

レジストラーは、おそらく Microsoft Lync Server 2010 の中で最も重要なコンポーネントです。レジストラーがなければ、ユーザーはシステムにログオンできず、Lync Server 2010 はユーザーの追跡とユーザーの現在の状態の把握を行うことができないからです。Lync Server にユーザーがログオンすると、ユーザーがログオンしたエンドポイント (コンピューター、携帯電話、またはその他のデバイス) は REGISTER 要求を登録サーバーに送信します。次に、サーバーは、クライアント デバイスに対する認証資格情報のチャレンジによって応答します。クライアントがチャレンジをパスすると (つまり、クライアントが有効な資格情報のセットを提出すると)、ユーザーは認証され、IP アドレス、ポート、およびユーザー名などのエンドポイント情報が登録データベースに記録されます。ユーザーがログオフすると、この情報はデータベースから削除されます。ログオンからログオフまでの間、レジストラーは最新の状態情報を保持し、ユーザー間でのメッセージのルーティングを支援します。

Set-CsRegistrar コマンドレットでは、組織内の 1 つまたは複数のレジストラーのプロパティを変更できます。ポート設定を変更できるほか、レジストラーが使用できなくなった場合に実行するアクションの指定も変更できます。

このコマンドレットを実行できるメンバー。既定では、次のグループのメンバーが Set-CsRegistrar コマンドレットのローカル実行を承認されています。RTCUniversalServerAdmins。このコマンドレットが割り当てられているすべての役割ベースのアクセス制御 (RBAC) の役割の一覧 (自身が作成したカスタムの RBAC の役割を含む) を戻すには、Windows PowerShell プロンプトから次のコマンドを実行します。

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsRegistrar\b"}

パラメーター

入力の種類

なし。Set-CsRegistrar はパイプライン入力を受け入れません。

戻り値の種類

Set-CsRegistrar を実行しても、オブジェクトや値が戻されることはありません。代わりに、Microsoft.Rtc.Management.Xds.DisplayRegistrar オブジェクトの既存のインスタンスを変更します。

例

-------------------------- 例 1 --------------------------

Set-CsRegistrar -Identity "Registrar:atl-cs-001.litwareinc.com" -SipPort 5072

例 1 に示すコマンドでは、レジストラー Registrar:atl-cs-001.litwareinc.com の SIP ポートを 5072 に設定します。

-------------------------- 例 2 --------------------------

Get-CsService -Registrar | ForEach-Object {Set-CsRegistrar -Identity $_.Identity -SipPort 5072}

上記のコマンドでは、組織内のすべてのレジストラーの SIP ポートを 5072 に設定します。この処理を行うため、まず Get-CsService と Registrar パラメーターを使用して、現在使用されているすべてのレジストラーのコレクションを戻しています。次に、このコレクションは ForEach-Object コマンドレットにパイプ処理され、コレクションの各レジストラーを取り出し、Set-CsRegistrar コマンドレットを使用して SIP ポートを 5072 に変更しています。

-------------------------- 例 3 --------------------------

Set-CsRegistrar -Identity "Registrar:atl-cs-001.litwareinc.com" -BackupRegistrar "Registrar:dublin-cs-001.litwareinc.com" -EnableAutomaticFailover $True

例 3 では、レジストラー Registrar:atl-cs-001.litwareinc.com のバックアップ レジストラー (BackupRegistrar) と自動フェールオーバー (EnableAutomaticFailover) の両方を構成しています。

関連項目

その他のリソース

Get-CsService