Get-CsUCPhoneConfiguration
トピックの最終更新日: 2012-03-23
Microsoft Lync 2010 Phone Edition の管理オプションに関する情報を戻します。管理オプションには、必須のセキュリティ モードや、指定したアイドル時間が過ぎれば電話が自動的にロックされるかどうかなどが含まれます。
構文
Get-CsUCPhoneConfiguration [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]
Get-CsUCPhoneConfiguration [-Filter <String>] [-LocalStore <SwitchParameter>]
解説
Lync 2010 Phone Edition は、電話と Microsoft Lync 2010 の融合を表します。Lync 2010 Phone Edition では、ボイス オーバー IP (VoIP) 電話として機能する特別なハードウェア (つまり、Lync 2010 互換の電話) を使用します。また、このハードウェアは、Lync 2010 のようなエンドポイントとしても機能できます。ユーザーは次のことを行えます。現在のステータスの設定、Lync 2010 連絡先のステータスのチェック、新しい連絡先の検索、Lync 2010 で作業をするときに使用する他の多くのアクティビティの実行。
CsUCPhoneConfiguration コマンドレットを使用すると、Lync 2010 電話を管理することができます。たとえば、電話にログオンするために使用する暗証番号 (PIN) の最小桁数や、指定した期間にわたって非アクティブ状態が続いた後に電話が自動的にロックされるかどうかなどの項目を制御できます。
電話の構成設定は、グローバル スコープ、またはサイト スコープのいずれかで適用できます (サイト スコープで適用された設定は、グローバル スコープで適用された設定よりも優先されます)。Get-CsUCPhoneConfiguration コマンドレットを使用すると、組織全体で現在使用されている電話の構成設定に関する情報を取得することができます。
このコマンドレットを実行できるユーザー:既定では、次のグループのメンバーが、Get-CsUCPhoneConfiguration コマンドレットをローカルで実行することを承認されています。RTCUniversalUserAdmins、RTCUniversalServerAdmins。このコマンドレットが割り当てられているすべての役割ベースのアクセス制御 (RBAC) の役割の一覧 (自身が作成したカスタムの RBAC の役割を含む) を戻すには、Windows PowerShell プロンプトから次のコマンドを実行します。
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsUCPhoneConfiguration"}
パラメーター
| パラメーター | 必須かどうか | 型 | 説明 |
|---|---|---|---|
Identity |
省略可能 |
Xds Identity |
取得する統合コミュニケーション (UC) 電話構成設定のコレクションに対する一意の識別子を示します。グローバル設定を参照するには、次の構文を使用します。-Identity global。サイト スコープで構成されるコレクションを参照するには、次のような構文を使用します。-Identity "site:Redmond"。Identity 指定時はワイルドカードを使用できないことに注意してください。ワイルドカードを使用する必要がある場合は、代わりに Filter パラメーターを指定します。 Identity パラメーターが指定されていない場合、Get-CsUCPhoneConfiguration は、組織内で使用中のすべての UC 電話構成設定のコレクションを戻します。 |
Filter |
省略可能 |
文字列 |
UC 電話構成設定の 1 つのコレクション (または複数のコレクション) を戻すために、ワイルドカード文字を使用できます。サイト スコープで構成されるすべての設定のコレクションを戻すには、次の構文を使用します。-Filter site:*。Identity (フィルター処理を行うことができる唯一のプロパティ) に "EMEA" という文字列が含まれたすべての設定のコレクションを戻すには、次の構文を使用します。-Filter *EMEA* です。 |
LocalStore |
省略可能 |
スイッチ パラメーター |
中央管理ストア自体ではなく、中央管理ストアのローカル レプリカから UC 電話構成データを取得します。 |
入力の種類
なし。Get-CsUCPhoneConfiguration はパイプライン処理された入力を受け入れません。
戻り値の種類
Get-CsUCPhoneConfiguration は、Microsoft.Rtc.Management.WritableConfig.Policy.Voice.UcPhoneSettings オブジェクトのインスタンスを戻します。
例
-------------------------- 例 1 --------------------------
Get-CsUCPhoneConfiguration
例 1 のコマンドは、組織内で現在使用中の、すべての UC 電話構成設定を戻します。パラメーターを追加せずに Get-CsUCPhoneConfiguration を呼び出すと、常に電話構成設定の完全なコレクションが戻されます。
-------------------------- 例 2 --------------------------
Get-CsUCPhoneConfiguration -Identity site:Redmond
例 2 では、Identity が site:Redmond である UC 電話構成設定のみが戻されます。Identity は一意である必要があるため、このコマンドが電話構成設定の複数のコレクションを戻すことはありません。
-------------------------- 例 3 --------------------------
Get-CsUCPhoneConfiguration -Filter site:*
上記のコマンドでは、サイト スコープで構成されているすべての UC 電話設定が戻されます。これを実行するために、Get-CsUCPhoneConfiguration が、Filter パラメーター付きで呼び出されています。この "site:*" というフィルター値によって、戻されるデータが、Identity プロパティ (フィルター処理できる唯一のプロパティ) が "site:" という文字列で始まる設定に限定されます。定義上、"site:" という文字列で始まる Identity を持つ設定はすべて、サイト スコープで構成されている設定です。
-------------------------- 例 4 --------------------------
Get-CsUCPhoneConfiguration | Where-Object {$_.SIPSecurityMode -eq "Medium"}
例 4 は、SIP セキュリティ モードが Medium に設定されている UC 電話構成設定を戻します(SIP セキュリティには、Low、Medium、または High を設定することができます)。このタスクを実行するため、このコマンドは最初に Get-CsUCPhoneConfiguration をパラメーターなしで使用して、この組織内で使用するように構成された、すべての UC 電話設定を戻します。その後、このコレクションが Where-Object コマンドレットにパイプ処理されます。このコマンドレットは、SIPSecurityMode プロパティが Medium と等しい設定のみを選択します。
-------------------------- 例 5 --------------------------
Get-CsUCPhoneConfiguration | Where-Object {$_.EnforcePhoneLock -eq $False -or $_.MinPhonePinLength -lt 6}
例 5 では、次の条件の 1 つまたは両方を満たす UC 電話設定が戻されます。1) 電話のロックが実行されない、かつ/または、2) 暗証番号 (PIN) の最小桁数が 6 桁未満であるというものです。この処理を行うため、コマンドはまず、Get-CsUCPhoneConfiguration を呼び出して、組織内で現在使用されているすべての UC 電話設定のコレクションを戻します。その後、これらのコレクションは Where-Object にパイプ処理されます。このコマンドレットは、次の条件の 1 つ (または両方) を満たす項目のみを選択します。1) EnforcePhoneLock プロパティが False に等しい、かつ/または 2) MinPhoneLength プロパティが 6 未満であるというものです。
-or 演算子は Where-Object に対して、条件の 1 つ (または両方) を満たす設定を選択するように指示します。両方の条件を満たす (この場合、電話のロックが実行されず、かつ、PIN のサイズが 6 未満である) 設定を選択するには、次のように -and 演算子を使用します。
Where-Object {$_.EnforcePhoneLock -eq $False -and $_.MinPhonePinLength -lt 6}