Get-CsLocationPolicy
トピックの最終更新日: 2012-03-23
Enhanced 9-1-1 (E9-1-1) 場所情報サービスがどのように構成されているか (または構成されているかどうか) に関する情報を戻します。E9-1-1 サービスにより、緊急電話に応答するスタッフが発信者の地理的な場所を特定できます。UNRESOLVED_TOKEN_VAL(ps-intro-in-LS2010)
構文
Get-CsLocationPolicy [-Identity <XdsIdentity>] <COMMON PARAMETERS>
Get-CsLocationPolicy [-Filter <String>] <COMMON PARAMETERS>
COMMON PARAMETERS: [-LocalStore <SwitchParameter>] [-Tenant <Guid>]
例
例 1
例 1 では、組織で現在使用されているすべての場所のポリシーのコレクションを戻しています。パラメーターを指定せずに Get-CsLocationPolicy コマンドレットを呼び出すだけで、これを行っています。
Get-CsLocationPolicy
例 2
例 2 のコマンドでは、Reno と等しい ID を持つ場所のポリシーのみ戻しています。ID は一意である必要があるため、このコマンドで戻される場所のポリシーは最大でも 1 つのみです。
Get-CsLocationPolicy -Identity Reno
例 3
例 3 では、Filter パラメーターを使用して、ユーザーごとのスコープで構成されているすべての場所のポリシーを返しています (ユーザーごとのスコープで構成されているポリシーは、ユーザーやネットワーク サイトに直接割り当てることができます)。ワイルドカード文字列 tag:* は、返されるデータを tag: という文字列で始まる ID を持つ場所のポリシーに制限するように、Get-CsLocationPolicy コマンドレットに指示するものです。個々のポリシーを取得する際にプレフィックス tag: を指定する必要はありませんが、このプレフィックスを使用すると、ユーザーごとのポリシーのすべてに対するフィルター処理を実行できます。
Get-CsLocationPolicy -Filter tag:*
例 4
例 4 では、拡張緊急サービスが無効になっている場所のポリシーのコレクションを戻しています。これを行うために、コマンドでまず Get-CsLocationPolicy コマンドレットを使用して、組織で現在使用されているすべての場所のポリシーのコレクションを戻します。次に、このコレクションは Where-Object コマンドレットにパイプ処理されます。これにより Where-Object コマンドレットを使用して、EnhancedEmergencyServicesEnabled プロパティが False ($False) と等しい (-eq) ポリシーに返りデータを制限するフィルターを適用します。
Get-CsLocationPolicy | Where-Object {$_.EnhancedEmergencyServicesEnabled -eq $False}
解説
場所のポリシーは、E9-1-1 機能に関連する設定を適用するために使用します。場所のポリシーには、ユーザーを E9-1-1 に対して有効にするかどうか、および有効にする場合、緊急電話の動作を指定します。たとえば、場所のポリシーを使用して、緊急電話 (米国の場合、911) を構成する番号、社内セキュリティに自動的に通知するかどうか、通話をルーティングする方法などを定義できます。このコマンドレットを実行すると、1 つ以上の場所のポリシーが取得されます。
このコマンドレットを実行できるメンバー。既定では、次のグループのメンバーが Get-CsLocationPolicy コマンドレットのローカル実行を承認されています。RTCUniversalUserAdmins、RTCUniversalServerAdmins。このコマンドレットが割り当てられているすべての役割ベースのアクセス制御 (RBAC) の役割の一覧 (自身が作成したカスタムの RBAC の役割を含む) を戻すには、Windows PowerShell プロンプトから次のコマンドを実行します。
Get-CsAdminRole | Where-Object {$_.Cmdlets -match "Get-CsLocationPolicy"}
パラメーター
パラメーター | 必須かどうか | 型 | 説明 |
---|---|---|---|
Filter |
省略可能 |
System.String |
ポリシーの ID 値をワイルドカード文字列と照合することで、場所のポリシーを取得する、ワイルドカード文字を含む文字列。 |
Identity |
省略可能 |
Microsoft.Rtc.Management.Xds.XdsIdentity |
取得する場所のポリシーの一意の識別子。グローバルの場所のポリシーを取得するには、Global という値を使用します。サイト スコープで作成されたポリシーの場合、この値は site:<サイト名> という形式になります。このサイト名は、Lync Server の展開で定義されているサイトの名前です (たとえば、site:Redmond)。ユーザーごとのスコープで作成されたポリシーの場合、この値は単純にポリシーの名前 (Reno など) になります。 |
LocalStore |
省略可能 |
System.Management.Automation.SwitchParameter |
中央管理ストア 自体からではなく、中央管理ストア のローカル レプリカから場所のポリシー情報を取得します。 |
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 パラメーターはハイブリッド展開で主に使用されます。 |
入力の種類
なし。
戻り値の種類
Get-CsLocationPolicy コマンドレットを実行すると、Microsoft.Rtc.Management.WritableConfig.Policy.Location.LocationPolicy オブジェクトのインスタンスが戻されます。