Set-CsLisLocation

構文

Set-CsLisLocation -City <String> -CompanyName <String> -Country <String> -HouseNumber <String> -HouseNumberSuffix <String> -Location <String> -PostalCode <String> -PostDirectional <String> -PreDirectional <String> -State <String> -StreetName <String> -StreetSuffix <String> [-Confirm [<SwitchParameter>]] [-WhatIf [<SwitchParameter>]]

Set-CsLisLocation -Instance <PSObject> [-City <String>] [-CompanyName <String>] [-Confirm [<SwitchParameter>]] [-Country <String>] [-HouseNumber <String>] [-HouseNumberSuffix <String>] [-Location <String>] [-PostalCode <String>] [-PostDirectional <String>] [-PreDirectional <String>] [-State <String>] [-StreetName <String>] [-StreetSuffix <String>] [-WhatIf [<SwitchParameter>]]

解説

E9-1-1 により、緊急電話を受けた人は、発信者の地理的な位置を聞かなくても、その人がどこから通話しているのかを判別できます。Microsoft Lync Server 2010 では、発信者のポート、サブネット、スイッチ、またはワイヤレス アクセス ポイントの特定の位置へのマッピングを基にして位置を判別します (このマップはワイヤマップとも呼ばれます)。このコマンドレットは、場所情報サーバー (LIS) 上の場所構成データベースに格納された場所の一覧に新しいアドレスを追加するか、または既存のアドレスを変更します。次に、その場所は会社と連携している緊急サービス プロバイダーにより提供された有効なアドレスの一覧と照合されます。

このコマンドレットに必要なすべてのパラメーター (Instance 以外) の組み合わせは、一意のエントリを構成します。これらのパラメーターのいずれかを変更すると、既存の場所が変更されるのではなく、新しい場所が作成されます。これらすべてのパラメーターは必要ですが、Null 値を含むことができるものもあります。Null 以外の値を含まなければならないパラメーターは次のとおりです。Location、HouseNumber、StreetName、City、State、および Country です。既存の値を変更するには、Instance パラメーターを使用する必要があります (またはインスタンスをコマンドレットにパイプ処理します)。

このコマンドレットを使用して場所を作成するのに加えて、新しいアドレスがポート、サブネット、スイッチ、またはワイヤレス アクセス ポイント情報に対して入力される場合も、場所が自動的に作成されます。この情報は、Set-CsLisPort、Set-CsLisSubnet、Set-CsLisSwitch、および Set-CsLisWirelessAccessPoint コマンドレットを使用して入力できます。

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

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

パラメーター

入力の種類

LIS 場所オブジェクトのパイプ処理による入力を受け入れます。

戻り値の種類

このコマンドレットは、値またはオブジェクトを戻しません。System.Management.Automation.PSCustomObject 型のオブジェクトを作成または変更します。

例

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

Set-CsLisLocation -Location Bldg30NEWing -HouseNumber 1000 -StreetName Main -City Redmond -State WA -Country US

例 1 は Bldg30NEWing という名前の新しい場所を作成します。このコマンドにより、作成する場所に対し、値が必要なすべてのパラメーターが入力されます。この例の場所の住所は、米国ワシントン州レドモンド メインストリート 1000 です。このアドレスは、HouseNumber パラメーターに値 1000、StreetName パラメーターに値 Main、City パラメーターに値 Redmond、Country パラメーターに値 US を指定して入力されます。

ここに示すパラメーターを指定してコマンドを実行すると、さらにパラメーターの入力を要求されることに気をつけてください。しかし、値を入力せずに Enter キーを押すだけでも場所は作成されます。

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

Set-CsLisLocation -Location "Suite 100/Office 20" -CompanyName "Litware, Inc." -HouseNumber 1234 -HouseNumberSuffix "" -PreDirectional "" -StreetName Main -StreetSuffix St -PostDirectional "" -City Redmond -State WA -PostalCode 99999 -Country US

この例は例 1 と同様に、新しい場所を作成します。ただし、この例では、コマンドレットのすべてのパラメーターを指定します。この例では空白にしておきたいすべての値を空の文字列に設定するだけなので、例 1 のコマンドで表示されるプロンプトは表示されなくなります。

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

$a = Get-CsLisLocation | Where-Object {$_.Location -ceq "Bldg30NEWing"}
Set-CsLisLocation -Instance $a -StreetSuffix Street

この例では、例 1 で作成した場所を変更します。この例の最初の行では、まず Get-CsLisLocation コマンドレットを呼び出しています。これにより Lync Server 2010 の展開内で定義されたすべての場所のコレクションが戻されます。次に、このコレクションを Where-Object コマンドレットへパイプ処理します。Where-Object は、Location プロパティが Bldg30NEWing に大文字と小文字の区別も含めて一致する (-ceq) 項目を、コレクションからすべて取得します。この条件に一致するオブジェクトが変数 $a に割り当てられます。

2 行目では、Set-CsLisLocation を呼び出します。最初のパラメーターは Instance パラメーターです。このパラメーターに 1 行目で取得したオブジェクトを含む変数 ($a) を渡します。これが変更するオブジェクトです。次に StreetSuffix パラメーターを指定して、Street という値を渡します。これにより変数 $a 内の場所の StreetSuffix プロパティの値が Street に変更されます。

Location プロパティは一意ではありません。このため、Where-Object コマンドレットによって、複数の場所が戻される場合があります。その場合、この例は動作しません。一度に複数の場所を変更するには、例 4 を参照してください。

-------------------------- 例 4 --------------------------

$a = Get-CsLisLocation | Where-Object {$_.Location -ceq "NorthCampus"}
$a | Set-CsLisLocation -StreetSuffix Avenue

例 4 では、1 つまたは複数の場所オブジェクトの StreetSuffix プロパティを変更します。この例の最初は、例 3 とよく似ています。まず Get-CsLisLocation を呼び出し、すべての場所を取得します。次に、この場所のコレクションを Where-Object へパイプ処理し、Location プロパティが NorthCampus に等しい場所のみのコレクションに絞り込みます。この新しいコレクションが、変数 $a に格納されます。2 行目で、$a の内容を Set-CsLisLocation コマンドレットへパイプ処理します。このコマンドレットは $a に格納された各オブジェクト (各場所)を調べてそのオブジェクトを変更します。この例では、各オブジェクトの StreetSuffix プロパティを Avenue に変更しています。

この例のコマンドは、変数を使用しなくても実行することができます。次のように、Where-Object コマンドの結果を、Set-CsLisLocation コマンドへパイプ処理するだけです。

Get-CsLisLocation | Where-Object {$_.Location -ceq "NorthCampus"} | Set-CsLisLocation -StreetSuffix Avenue

関連項目

その他のリソース

Remove-CsLisLocation
Get-CsLisLocation
Set-CsLisPort
Set-CsLisSubnet
Set-CsLisSwitch
Set-CsLisWirelessAccessPoint
Get-CsLisCivicAddress