Get-CsUserServicesConfiguration
トピックの最終更新日: 2012-03-23
組織で使用されている User Services の構成設定に関する情報を戻します。 User Services サービスは、プレゼンス情報を維持したり、会議を管理するのに役立ちます。
構文
Get-CsUserServicesConfiguration [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]
Get-CsUserServicesConfiguration [-Filter <String>] [-LocalStore <SwitchParameter>]
解説
Microsoft Lync Server 2010 では、User Services サービスを使用して、ユーザーのプレゼンス情報を維持したり、各種の会議を管理したりします。 同様に、CsUserServicesConfiguration コマンドレットを使用して、グローバル スコープ、サイト スコープ、およびサービス スコープでUser Services 設定を管理します (User Services の構成設定をホストできるサービスは、User Services 自体だけであることに注意してください)。 これらの設定を使用すると、ユーザーが登録可能な連絡先の数、ユーザーが一度にスケジュール可能な会議の数、および特定の会議がアクティブの状態を継続できる時間などを決定するのに役立ちます。
Get-CsUserServicesConfiguration コマンドレットを実行すると、管理者は、現在使用されている User Services 構成設定のいずれか (またはすべて) に関する情報を取得できます。
このコマンドレットを実行できるユーザー: 既定では、次のグループのメンバーが、Get-CsUserServicesConfiguration コマンドレットをローカルで実行することを承認されています。 RTCUniversalUserAdmins、RTCUniversalServerAdmins。 このコマンドレットが割り当てられているすべての役割ベースのアクセス制御 (RBAC) の役割の一覧 (自身が作成したカスタムの RBAC の役割を含む) を戻すには、Windows PowerShell プロンプトから次のコマンドを実行します。
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsUserServicesConfiguration"}
パラメーター
| パラメーター | 必須かどうか | 型 | 説明 |
|---|---|---|---|
Identity |
省略可能 |
Xds Identity |
戻される User Services 構成設定の一意の識別子。 グローバル設定を戻すには、次の構文を使用します。 -Identity global。 サイト スコープで構成された設定を戻すには、次のような構文を使用します。 -Identity site:Redmond。 サービス レベルの設定を戻すには、次のような構文を使用します。 -Identity service:UserServer:atl-cs-001.litwareinc.com。 このパラメーターを省略した場合は、Get-CsUserServicesConfiguration によって、組織で現在使用されているすべての User Services 構成設定が戻されます。 |
Filter |
省略可能 |
文字列 |
User Services 構成設定のコレクションを 1 つ以上取得する際に、ワイルドカードを使用できます。 たとえば、サイト スコープで構成されているすべての設定を戻すには、次の構文を使用します。 -Filter "site:*"。 サービス スコープで構成されているすべての設定を戻すには、次の構文を使用します。 -Filter "service:*"。 |
LocalStore |
省略可能 |
スイッチ パラメーター |
中央管理ストア 自体ではなく、中央管理ストア のローカル レプリカから User Services 構成データを取得します。 |
入力の種類
なし。 Get-CsUserServicesConfiguration はパイプライン処理された入力を受け入れません。
戻り値の種類
Get-CsUserServicesConfiguration を実行すると、Microsoft.Rtc.Management.WritableConfig.Settings.UserServices.UserServicesSettings オブジェクトのインスタンスが戻されます。
例
-------------------------- 例 1 --------------------------
Get-CsUserServicesConfiguration
例 1 のコマンドを実行すると、組織で現在使用されているすべての User Services 構成設定のコレクションが戻されます。 追加パラメーターを指定せずに Get-CsUserServicesConfiguration を呼び出すことで、これを行っています。
-------------------------- 例 2 --------------------------
Get-CsUserServicesConfiguration -Identity site:Redmond
例 2 では、User Services 構成設定の 1 つのコレクション (site:Redmond という Identity を持つコレクション) のみが戻されます。 Identity は一意である必要があるため、このコマンドで複数の項目が戻されることはありません。
-------------------------- 例 3 --------------------------
Get-CsUserServicesConfiguration -Filter "service:*"
例 3 では、サービス スコープで適用されているすべての User Services 構成設定のコレクションが戻されます。 -Filter パラメーターを指定して Get-CsUserServicesConfiguration を呼び出すことで、これを行っています。フィルター値 "service:*" により、戻されるデータは、Identity が "service:" という文字で始まる設定に限定されます。 定義上、これらは、サービス スコープで構成された設定です。
-------------------------- 例 4 --------------------------
Get-CsUserServicesConfiguration | Where-Object {$_.MaxContacts -gt 250}
上記のコマンドを実行すると、ユーザーに対して 250 よりも多くの連絡先を使用することを許可している、すべての User Services 構成設定が戻されます。 これを行うために、現在使用されているすべての User Services 構成設定のコレクションが戻されるよう、コマンドでまず、追加パラメーターを指定せずに Get-CsUserServicesConfiguration を呼び出します。 このコレクションが Where-Object コマンドレットにパイプ処理され、MaxContacts プロパティが 250 よりも大きい設定のみが取得されます。
-------------------------- 例 5 --------------------------
Get-CsUserServicesConfiguration | Where-Object {$_.AnonymousUserGracePeriod -gt "00:10:00"}
例 5 では、匿名ユーザーの猶予期間が 10 分よりも長い User Services 構成設定に関する情報が報告されます。 このタスクを実行するために、コマンドでまず、追加パラメーターを指定せずに Get-CsUserServicesConfiguration を呼び出します。これにより、組織で使用されているすべての User Services 構成設定のコレクションが戻されます。 戻されたコレクションが Where-Object にパイプ処理され、AnonymousUserGracePeriod プロパティが 10 分よりも長い設定のみが取得されます (0 時間: 10 分: 00 秒)。