Get-CsMeetingConfiguration
トピックの最終更新日: 2012-03-23
Get-CsMeetingConfiguration を使用すると、組織で現在使用中の会議構成設定に関する情報を戻すことができます。会議の構成設定では、ユーザーが作成できる会議 (または "ミーティング" とも呼ばれます) の種類を指定でき、さらにこの会議への匿名ユーザーやダイヤルイン会議ユーザーの参加方法について (または、参加可能かどうかについても) 制御できます。
構文
Get-CsMeetingConfiguration [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>] [-Tenant <Nullable>]
Get-CsMeetingConfiguration [-Filter <String>] [-LocalStore <SwitchParameter>] [-Tenant <Nullable>]
解説
会議 (または "ミーティング" とも呼ばれます) は、Microsoft Lync Server 2010 の重要な機能です。CsMeetingConfiguration コマンドレットを使用すると、管理者は、ユーザーが作成可能な会議のタイプを制御したり、会議で匿名ユーザーとダイヤルイン会議ユーザーをどのように処理するのかを指定できます。たとえば、公衆交換電話網 (PSTN) 経由でダイヤルインするすべてのユーザーが自動的に会議への参加を許可されるよう、会議を構成できます。または、ダイヤルイン ユーザーは自動的には会議への参加は許可されないが、代わりに会議のロビーにルーティングされるよう、会議を構成することもできます。これらのダイヤルイン ユーザーは、開催者が会議への参加を許可するまで、ロビーで保留状態になります。
Get-CsMeetingConfiguration を使用すると、組織で現在使用中の会議構成設定のコレクションに関する情報を戻すことができます。
このコマンドレットを実行できるユーザー:既定では、次のグループのメンバーが、Get-CsMeetingConfiguration コマンドレットのローカル実行を承認されています。RTCUniversalUserAdmins、RTCUniversalServerAdmins。このコマンドレットが割り当てられているすべての役割ベースのアクセス制御 (RBAC) の役割の一覧 (自身が作成したカスタムの RBAC の役割を含む) を戻すには、Windows PowerShell プロンプトから次のコマンドを実行します。
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsMeetingConfiguration"}
パラメーター
パラメーター | 必須かどうか | 型 | 説明 |
---|---|---|---|
Identity |
省略可能 |
Xds identity |
戻す会議構成設定コレクションの一意の識別子を指定します。グローバル設定を参照するには、次の構文を使用します。-Identity global。サイト スコープで構成されるコレクションを参照するには、次のような構文を使用します。-Identity site:Redmond。サービス スコープで構成された設定は、次のような構文を使用して取得できます。-Identity service:UserServer:atl-cs-001.litwareinc.com。 このパラメーターが指定されていない場合、Get-CsMeetingConfiguration は、組織で使用中のすべての会議設定のコレクションを戻します。 Identity 指定時はワイルドカードを使用できないことに注意してください。ワイルドカードを使用する必要がある場合は、代わりに Filter パラメーターを指定します。 |
Filter |
省略可能 |
文字列 |
ワイルドカード文字を使用して、会議構成設定のコレクション (1 つまたは複数) を戻すことができます。サイト スコープで構成されるすべての設定のコレクションを戻すには、次の構文を使用します。-Filter site:*。Identity (フィルター処理できる唯一のプロパティ) の一部に文字列値 "EMEA" を含むすべての設定のコレクションを戻すには、次の構文を使用します。-Filter *EMEA*。 |
Tenant |
省略可能 |
Guid |
社内バージョンの Lync Server 2010 では、このパラメーターを使用しません。 |
LocalStore |
省略可能 |
スイッチ パラメーター |
中央管理ストア 自体からではなく、中央管理ストア のローカル レプリカから会議構成データを取得します。 |
入力の種類
なし。Get-CsMeetingConfiguration は、パイプ処理されたデータを受け入れません。
戻り値の種類
Get-CsMeetingConfiguration は、Microsoft.Rtc.Management.WritableConfig.Settings.UserServices.MeetingConfiguration オブジェクトのインスタンスを戻します。
例
-------------------------- 例 1 ------------------------
Get-CsMeetingConfiguration
例 1 に示すコマンドは、現在組織で使用中のすべての会議構成設定のコレクションを戻します。
-------------------------- 例 2 ------------------------
Get-CsMeetingConfiguration -Identity site:Redmond
例 2 では、次の会議構成設定のコレクションを 1 つだけ戻します。site:Redmond という Identity を持つフィルターに関する設定です。
-------------------------- 例 3 ------------------------
Get-CsMeetingConfiguration -Filter "service:*"
上記のコマンドは、サービス スコープで構成されていたすべての会議構成設定を戻します。これを行うため、フィルター値を "service:*" にして Filter パラメーターを指定しています。これにより、戻されるデータを Identity プロパティが文字列 "service:" で始まる設定に制限します。
-------------------------- 例 4 ------------------------
Get-CsMeetingConfiguration | Where-Object {$_.AdmitAnonymousUsersByDefault -eq $True}
例 4 では、既定で匿名ユーザーが許可されているすべての会議構成設定の情報を戻します。このタスクを実行するため、このコマンドはまず、パラメーターを指定せずに Get-CsMeetingConfiguration を使用して、現在使用中のすべての会議構成設定のコレクションを戻します。このコレクションを Where-Object コマンドレットにパイプ処理し、AdmitAnonymousByDefault プロパティが True と等しい設定のみ取得します。