Set-CsLocationPolicy
トピックの最終更新日: 2012-03-26
既存の場所ポリシーを変更します。UNRESOLVED_TOKEN_VAL(ps-intro-in-LS2010)
構文
Set-CsLocationPolicy [-Identity <XdsIdentity>] <COMMON PARAMETERS>
Set-CsLocationPolicy [-Instance <PSObject>] <COMMON PARAMETERS>
COMMON PARAMETERS: [-ConferenceMode <oneway | twoway>] [-ConferenceUri <String>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-EmergencyDialMask <String>] [-EmergencyDialString <String>] [-EnhancedEmergencyServiceDisclaimer <String>] [-EnhancedEmergencyServicesEnabled <$true | $false>] [-Force <SwitchParameter>] [-LocationRefreshInterval <Int64>] [-LocationRequired <yes | no | disclaimer>] [-NotificationUri <String>] [-PstnUsage <String>] [-Tenant <Guid>] [-UseLocationForE911Only <$true | $false>] [-WhatIf [<SwitchParameter>]]
例
例 1
このコマンドは Set-CsLocationPolicy コマンドレットを使用して、Identity が site:Redmond の場所のポリシーを変更します (つまり、Redmond サイトに適用される場所のポリシーを変更します)。この例では、EnhancedEmergencyServicesEnabled プロパティの値を True に設定し、(この場合) Redmond サイトに接続されたすべてのユーザーに対して E9-1-1 機能を有効にします。
Set-CsLocationPolicy -Identity site:Redmond -EnhancedEmergencyServicesEnabled $True
例 2
例 2 は、電話会議 URI を定義し 2 ウェイの会議モードを利用している組織内で使用されている、すべての場所のポリシーを変更します。このタスクを実行するため、まず Get-CsLocationPolicy コマンドレットを使用して、現在定義されているすべての場所のポリシーのコレクションを戻しています。次に、このコレクションを Where-Object コマンドレットにパイプ処理し、ConferenceUri プロパティが空ではない (Null に等しくない) 場所のポリシーのみに絞り込んでいます。この結果は ConferenceUri の値を持つ場所のポリシーのコレクションになります。その後、このコレクションを Set-CsLocationPolicy コマンドレットにパイプ処理し、コレクション内の各ポリシーの ConferenceMode プロパティの値を twoway に設定することで変更しています。
Get-CsLocationPolicy | Where-Object {$_.ConferenceUri -ne $null} | Set-CsLocationPolicy -ConferenceMode twoway
解説
場所のポリシーを使用して、Enhanced 9-1-1 (E9-1-1) 機能とクライアントの場所に関連する設定を適用します。場所のポリシーには、ユーザーを E9-1-1 に対して有効にするかどうか、および有効にする場合、緊急電話の動作を指定します。たとえば、場所のポリシーを使用して、緊急電話 (米国の場合、911) を構成する番号、社内セキュリティに自動的に通知するかどうか、および通話をルーティングする方法を定義できます。このコマンドレットは、既存の場所のポリシーを変更します。
このコマンドレットを実行できるユーザー: 既定では、次のグループのメンバーが、Set-CsLocationPolicy コマンドレットのローカル実行を承認されています。RTCUniversalServerAdmins。このコマンドレットが割り当てられているすべての役割ベースのアクセス制御 (RBAC) の役割の一覧 (自身が作成したカスタムの RBAC の役割を含む) を戻すには、Windows PowerShell プロンプトから次のコマンドを実行します。
Get-CsAdminRole | Where-Object {$_.Cmdlets -match "Set-CsLocationPolicy"}
パラメーター
| パラメーター | 必須 | 型 | 説明 |
|---|---|---|---|
ConferenceMode |
省略可能 |
Microsoft.Rtc.Management.WritableConfig.Policy.Location.ConferenceModeEnum |
ConferenceUri パラメーターに値を指定している場合、ConferenceMode パラメーターで、第三者が通話に参加できるかどうか、または通話を聞くことのみできるかどうかを指定します。使用できる値は次のとおりです。 - oneway: 第三者は、発信者と緊急情報受信センター (PSAP) 事業者の会話を聞くことのみできます。 - twoway: 第三者は、発信者と PSAP 事業者の通話に参加できます。 |
ConferenceUri |
省略可能 |
System.String |
緊急呼び出しの際に通話に加わる第三者の SIP URI (Uniform Resource Identifier) (この場合は電話番号) です。たとえば、会社の警備室は緊急呼び出しの際に呼び出しを受け、その通話を聞くかそれに参加する (ConferenceMode プロパティの値によって異なります) ことができます。 この文字列は 1 ～ 256 文字の長さで、プレフィックス sip: で始まっている必要があります。 |
Confirm |
省略可能 |
System.Management.Automation.SwitchParameter |
コマンドの実行前に確認メッセージを表示します。 |
Description |
省略可能 |
System.String |
この場所の詳しい説明です。たとえば、"Building 30, 3rd Floor, NorthEast corner" です。 |
EmergencyDialMask |
省略可能 |
System.String |
ダイヤルされた番号が EmergencyDialString プロパティの値に変換されます。たとえば、EmergencyDialMask の値が "212" であり、EmergencyDialString の値が "911" である場合は、ユーザーが 212 をダイヤルすると、911 に電話がかけられることを意味します。これにより、別の緊急電話番号をダイヤルしても、緊急サービスに通話を接続させることができます (緊急電話番号が異なる国/地域のユーザーが、現在滞在している国/地域の電話番号ではなく、その国/地域の電話番号をダイヤルしようとした場合など)。値をセミコロン (;) で区切って複数の緊急ダイヤル マスクを定義できます。たとえば、-EmergencyDialMask "212;414" のように入力します。 重要: 指定したダイヤル マスクの値が、コール パーク オービット (コール パーク オービット) の範囲内に含まれていないことを確認してください。コール パーク ルーティングは、緊急ダイヤル文字列の変換より優先されます。既存のコール パーク オービット範囲を表示するには、Get-CsCallParkOrbit コマンドレットを呼び出します。 この文字列の長さの上限は 100 文字です。各文字は 0 ～ 9 の数字である必要があります。 |
EmergencyDialString |
省略可能 |
System.String |
緊急サービス接続用のダイヤル番号です。米国の場合、この値は "911" です。 この文字列は 0 ～ 9 の数字で構成されている必要があり、1 ～ 10 文字の長さにすることができます。 |
EnhancedEmergencyServiceDisclaimer |
省略可能 |
System.String |
場所マップ (ワイヤマップ) で解決できない場所から接続していて、場所を手動で入力したくないユーザーに表示される情報を含んだテキスト値です。場所ポリシーからサービスの免責事項を削除するには、このプロパティに Null 値を設定します。 -EnhancedEmergencyServiceDisclaimer $Null Lync Server 15 では場所のポリシー、および EnhancedEmergencyServiceDisclaimer プロパティが使用され、これにより E9-1-1 サービスの免責事項が設定されます。これは、Lync Server 2010 とは異なります。ここでは、Set-CsEnhancedEmergencyServiceDisclaimer コマンドレットによって組織全体のグローバルの免責事項が設定されます。場所のポリシーを使用してこれらの免責事項を設定すると、さまざまなロケールや一連のユーザーに対して、それぞれ異なる免責事項を作成できます。 |
EnhancedEmergencyServicesEnabled |
省略可能 |
System.Boolean |
このポリシーに関連付けるユーザーに対して E9-1-1 を有効にするかどうかを指定します。値を True に設定すると E9-1-1 が有効になり、緊急電話がかけられると、Lync Server クライアントが登録された場所情報を取得してその情報を追加します。 |
Force |
省略可能 |
System.Management.Automation.SwitchParameter |
変更を行う前に表示されるように設定されているすべての確認メッセージを表示しないようにします。 |
Identity |
省略可能 |
Microsoft.Rtc.Management.Xds.XdsIdentity |
変更する場所のポリシーの一意の識別子です。グローバルな場所のポリシーを変更する場合は、Global という値を使用します。サイト スコープで作成されたポリシーの場合、この値は site:<サイト名> という形式になります。このサイト名は、Lync Server の展開で定義されたサイトの名前です (site:Redmond など)。ユーザーごとのスコープで作成されたポリシーの場合、この値は単純にポリシーの名前 (Reno など) になります。 |
Instance |
省略可能 |
LocationPolicy |
場所のポリシー オブジェクトへの参照です。このオブジェクトは Microsoft.Rtc.Management.WritableConfig.Policy.Location.LocationPolicy 型である必要があります。Get-CsLocationPolicy コマンドレットを呼び出すことで取得できます。このオブジェクトを取得してメモリ内でプロパティを変更し、その後オブジェクト参照を値としてこのパラメーターに渡して、その場所のポリシーを更新します。 |
LocationRefreshInterval |
省略可能 |
System.Int64 |
場所情報サービスの場所の更新に対するクライアント要求の時間間隔 (時間) を指定します。LocationRefreshInterval は、1 ～ 12 の範囲で任意の値に設定できます。既定値は 4 です。 |
LocationRequired |
省略可能 |
Microsoft.Rtc.Management.WritableConfig.Policy.Location.LocationRequiredEnum |
クライアントが場所構成データベースから場所を取得できなかった場合に、ユーザーに場所を手動で入力することを求めることができます。このパラメーターには、以下の値を指定できます。 - no: ユーザーに場所の入力を求めません。場所情報のない呼び出しがあった場合、緊急サービス プロバイダーが呼び出しに応答して場所をたずねます。 - yes: クライアントを新しい場所で登録する際、ユーザーに場所情報の入力を求めます。ユーザーは、情報を入力せずにプロンプトを閉じることができます。情報が入力されている場合、911 への通話はまず緊急サービス プロバイダーが応答し、場所を確認してから PSAP (つまり、911 のオペレーター) にルーティングされます。 - disclaimer: このオプションは yes と同じですが、ユーザーがプロンプトを閉じた場合は、免責事項に関するテキストを表示し、場所情報を入力しない場合に生じる結果についてユーザーに警告できます (免責事項に関するテキストは、Set-CsEnhancedEmergencyServiceDisclaimer コマンドレットを呼び出して設定する必要があります)。 この値は、EnhancedEmergencyServicesEnabled が False (既定値) に設定されている場合は無視されます。ユーザーに場所情報の入力を求めません。 |
NotificationUri |
省略可能 |
System.String |
緊急呼び出しが行われた際に通知を受ける 1 つまたは複数の SIP URI (Uniform Resource Identifier) です。たとえば、会社の警備室は緊急呼び出しの都度、インスタント メッセージによる通知を受け取ることができます。発信者の場所が入手可能な場合は、通知の中にその場所が含まれます。 カンマ区切りの一覧として複数の SIP URI を含めることができます (例: NotificationUri sip:security@litwareinc.com,sip:kmyer@litwareinc.com)。Lync Server 15 のリリースによって、配布リストを通知 URI として構成できるようになったことに注意してください。 この文字列は 1 ～ 256 文字の長さで、プレフィックス sip: で始まっている必要があります。 |
PstnUsage |
省略可能 |
System.String |
このプロファイルを使用するクライアントからの 911 通話を、どのボイス ルートでルーティングするかを決定するために使用される公衆交換電話網 (PSTN) 使用法です。この使用法に関連付けられたルートは、緊急通話専用の SIP トランクを参照している必要があります。 この使用法は、グローバル PSTN の使用法の一覧の中に存在していることが必要です。使用法の一覧を取得するには、Get-CsPstnUsage コマンドレットを呼び出します。新しい使用法を作成するには、Set-CsPstnUsage コマンドレットを呼び出します。 |
Tenant |
省略可能 |
System.Guid |
変更する場所ポリシーの Office 365 テナント アカウントのグローバル一意識別子 (GUID) です。次に例を示します。 -Tenant "38aad667-af54-4397-aaa7-e94c79ec2308" 次のコマンドを実行することにより、テナントの各々についてテナント ID を返すことができます。 Get-CsTenant | Select-Object DisplayName, TenantID Windows PowerShell のリモート セッションを使用していて、Lync Online 15 のみに接続している場合、Tenant パラメーターを含める必要はありません。代わりに、接続情報に基づいてテナント ID が自動的に入力されます。Tenant パラメーターはハイブリッド展開で主に使用されます。 |
UseLocationForE911Only |
省略可能 |
System.Boolean |
Lync Server クライアントは、場所情報をさまざまな理由 (チームメイトに現在の場所を知らせるなど) で使用できます。この値を True に設定すると、緊急通話で使用する場合に限り、場所情報を使用できます。 |
WhatIf |
省略可能 |
System.Management.Automation.SwitchParameter |
実際にコマンドを実行せずに、コマンドの実行結果がわかります。 |
入力の種類
Microsoft.Rtc.Management.WritableConfig.Policy.Location.LocationPolicy オブジェクト。場所ポリシー オブジェクトのパイプライン入力を受け入れます。
戻り値の種類
このコマンドレットは、値またはオブジェクトを戻しません。代わりに、Microsoft.Rtc.Management.WritableConfig.Policy.Location.LocationPolicy オブジェクトのインスタンスを構成します。