New-CsConferencingConfiguration
トピックの最終更新日: 2012-04-23
会議の構成設定の新しいコレクションを作成します。会議設定は、会議コンテンツや配布資料の最大許容サイズ、コンテンツの猶予期間 (コンテンツが削除されるまでに保存される期間)、サポートされているクライアントの内部および外部ダウンロード用 URL などを決定します。UNRESOLVED_TOKEN_VAL(ps-intro-in-LS2010)
構文
New-CsConferencingConfiguration -Identity <XdsIdentity> [-ClientAppSharingPort <UInt16>] [-ClientAppSharingPortRange <UInt32>] [-ClientAudioPort <UInt16>] [-ClientAudioPortRange <UInt32>] [-ClientFileTransferPort <UInt16>] [-ClientFileTransferPortRange <UInt32>] [-ClientMediaPort <UInt16>] [-ClientMediaPortRange <UInt32>] [-ClientMediaPortRangeEnabled <$true | $false>] [-ClientSipDynamicPort <UInt16>] [-ClientSipDynamicPortRange <UInt32>] [-ClientVideoPort <UInt16>] [-ClientVideoPortRange <UInt32>] [-CloudPollServicePrimaryUrl <String>] [-CloudPollServiceSecondaryUrl <String>] [-Confirm [<SwitchParameter>]] [-ConsoleDownloadExternalUrl <String>] [-ConsoleDownloadInternalUrl <String>] [-ContentGracePeriod <TimeSpan>] [-Force <SwitchParameter>] [-HelpdeskExternalUrl <String>] [-HelpdeskInternalUrl <String>] [-InMemory <SwitchParameter>] [-MaxBandwidthPerAppSharingServiceMb <UInt64>] [-MaxContentStorageMb <UInt16>] [-MaxUploadFileSizeMb <UInt16>] [-Organization <String>] [-WhatIf [<SwitchParameter>]]
例
例 1
例 1 に示すコマンドは、Redmond サイト (site:Redmond) の会議構成設定の新しいコレクションを作成します。この例には、Organization プロパティの値を Litwareinc に設定するために使用される追加のパラメーター (Organization) が 1 つ含まれています。Redmond サイトに既に会議構成設定のコレクションがある場合、このコマンドは失敗します。このようなコレクションは、1 サイトにつき 1 つしか存在できないためです。
New-CsConferencingConfiguration -Identity site:Redmond -Organization Litwareinc
例 2
例 2 では、会議構成設定の新しいコレクションが最初メモリ内にだけ作成され、これらの仮想設定が後から Redmond サイトに適用されます。これを行うため、例の最初のコマンドで New-CsConferencingConfiguration コマンドレットを使用して、新しい設定のコレクションをメモリ内に作成し、これを変数 $x に格納します。InMemory パラメーターで、コレクションを Redmond サイトにすぐに適用するのではなく、これをメモリ内に作成するよう指定します。
コレクションの作成後、2 番目のコマンドで Organization プロパティの値に Litwareinc を設定しています。最後に 3 番目のコマンドで、Set-CsConferencingConfiguration コマンドレットを使用して新しい設定を Redmond サイトに実際に適用します (会議構成設定が site:Redmond に適用済みの場合、このコマンドは失敗します)。Set-CsConferencingConfiguration コマンドレットを呼び出さない限り、新しい設定が有効になることはありません。代わりに Windows PowerShell セッションを終了するか、変数 $x を削除すると、これらの設定はすぐ消失します。
$x = New-CsConferencingConfiguration -Identity site:Redmond -InMemory
$x.Organization = "Litwareinc"
Set-CsConferencingConfiguration -Instance $x
解説
会議では、運用管理を行うコマンドレットは、2 つのセットに分かれています。ユーザーが実行できることと実行できないこと (ユーザーが匿名の参加者を会議参加に招待できるかどうかや、ユーザーに対して会議でのアプリケーションの共有や会議内のファイル転送を許可するかどうかなど) を管理する場合は、CsConferencingPolicy コマンドレットを使用する必要があります。
管理者も、Web 会議サービス を管理する必要があります。たとえば、1 つの会議に割り当てるコンテンツ記憶域の最大容量の指定や、会議資料を自動的に削除する前の猶予期間の指定などは、管理者が設定できる必要があります。また管理者は、アプリケーション共有やファイル転送などのアクティビティで使用するポートも指定できる必要があります。
上記のうち、後者の作業については CsConferencingConfiguration コマンドレットを使用して管理できます。このコマンドレット群を使用すると、実際のサーバーそのものを管理できます。CsConferencingConfiguration コマンドレット群はグローバル スコープにもサイト スコープにもサービス スコープにも適用できますが、あるユーザーが会議中にアプリケーションを共有できるかどうかを指定するのには使用できません。ただし、アプリケーション共有が許可されている場合は、このコマンド群でそのアクティビティに使用するポートを指定できます。同様に、このコマンドレット群では記憶域の上限、有効期限、およびユーザーが会議のヘルプやリソースを取得できる内部 URL と外部 URL も指定できます。
Lync Server をインストールすると、システムによって会議構成設定のコレクション (グローバル コレクション) が 1 つ提供されます。サイトまたはサービスに対してカスタム設定を作成する必要がある場合は、New-CsConferencingConfiguration コマンドレットを使用してその作業を行うことができます。新しい設定は、サイト スコープまたはサービス スコープにのみ適用でき、会議構成設定の新しいグローバル コレクションは作成できません。また、いかなるサイトやサービスも、設定のコレクションは 1 つしかホストできません。Redmond サイト向けの新しい設定を作成しようとしても、Redmond サイトが既に会議構成設定のコレクションをホストしている場合、そのコマンドは失敗します。
このコマンドレットを実行できるユーザー: 既定では、次のグループのメンバーが、New-CsConferencingConfiguration コマンドレットのローカル実行を承認されています。RTCUniversalServerAdmins。このコマンドレットが割り当てられているすべての役割ベースのアクセス制御 (RBAC) の役割の一覧 (自身が作成したカスタムの RBAC の役割を含む) を戻すには、Windows PowerShell プロンプトから次のコマンドを実行します。
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsConferencingConfiguration"}
パラメーター
| パラメーター | 必須かどうか | 型 | 説明 |
|---|---|---|---|
Identity |
必須かどうか |
Microsoft.Rtc.Management.Xds.XdsIdentity |
変更する会議構成設定コレクションの一意の識別子。サイト スコープで構成されるコレクションを参照するには、次のような構文を使用します。-Identity "site:Redmond"。サービス スコープのコレクションを参照するには、次のような構文を使用します。-Identity "service:ConferencingServer:atl-cs-001.litwareinc.com"。Web 会議サービスが、これらの構成設定をホストできる唯一のサービスであることに注意してください。 |
ClientAppSharingPort |
省略可能 |
System.UInt16 |
アプリケーション共有に使用する開始ポート番号を表します。ClientAppSharingPort は、1024 ～ 65535 の範囲のポート番号値にする必要があります。既定値は 5350 です。 |
ClientAppSharingPortRange |
省略可能 |
System.UInt32 |
アプリケーション共有に使用可能なポートの合計数を示します。(既定値は 40 です。)アプリケーション共有で実際に使用されるポートを決定するには、この値と ClientAppSharingPort 値を使用します。たとえば、ClientAppSharingPort が 5350、ClientAppSharingPortRange が 3 に設定されている場合、アプリケーション共有では 5350、5351、5352 の 3 ポートを使用できます。 |
ClientAudioPort |
省略可能 |
System.UInt16 |
クライアントの音声に使用する開始ポート番号を表します。ClientAudioPort は、1024 ～ 65535 の範囲のポート番号値にする必要があります。既定値は 5350 です。 |
ClientAudioPortRange |
省略可能 |
System.UInt32 |
クライアントの音声に使用可能なポートの合計数を示します。(既定値は 40 です。)クライアントの音声で実際に使用されるポートを決定するには、この値と ClientAudioPort 値を使用します。たとえば、ClientAudioPort が 5350、ClientAudioPortRange が 3 に設定されている場合、クライアントの音声では 5350、5351、5352 の 3 ポートを使用できます。 |
ClientFileTransferPort |
省略可能 |
System.UInt16 |
ファイル転送に使用する開始ポート番号を表します。ClientFileTransferPort は、1024 ～ 65535 の範囲のポート番号値にする必要があります。既定値は 5350 です。 |
ClientFileTransferPortRange |
省略可能 |
System.UInt32 |
ファイル転送に使用可能なポートの合計数を示します。(既定値は 40 です。)ファイル転送で実際に使用されるポートを決定するには、この値と ClientFileTransferPort 値を使用します。たとえば、ClientFileTransferPort が 5350、ClientFileTransferPortRange が 3 に設定されている場合、ファイル転送では 5350、5351、5352 の 3 ポートを使用できます。 |
ClientMediaPort |
省略可能 |
System.UInt16 |
クライアントのメディアに使用する開始ポート番号を表します。Microsoft Office Communicator 2007 R2 クライアントにはこのパラメーターを使用します。ClientMediaPort は、1024 ～ 65535 の範囲のポート番号値にする必要があります。既定値は 5350 です。 |
ClientMediaPortRange |
省略可能 |
System.UInt32 |
クライアントのメディアに使用可能なポートの合計数を示します。(既定値は 40 です。)Office Communicator 2007 R2 クライアントにはこのパラメーターを使用します。クライアント メディアで実際に使用されるポートを決定するには、この値と ClientMediaPort 値を使用します。たとえば、ClientMediaPort が 5350、ClientMediaPortRange が 3 に設定されている場合、クライアント メディアでは 5350、5351、5352 の 3 ポートを使用できます。 |
ClientMediaPortRangeEnabled |
省略可能 |
System.Boolean |
True に設定すると、クライアントは、メディア トラフィック用に指定されたポート範囲を使用します。False (既定値) に設定すると、すべての使用可能なポート (ポート 1024 ～ 65535) がメディア トラフィックに使用されます。 |
ClientSipDynamicPort |
省略可能 |
System.UInt16 |
SIP トラフィックに使用する開始ポート番号を表します。ClientSipDynamicPort は、1024 ～ 65535 の範囲のポート番号値にする必要があります。既定値は 7100 です。 |
ClientSipDynamicPortRange |
省略可能 |
System.UInt32 |
SIP トラフィックに使用可能なポートの合計数を示します。(既定値は 3 です。)SIP トラフィックで実際に使用されるポートを決定するには、この値と ClientSipDynamicPort 値を使用します。たとえば、ClientSipDynamicPort が 7100、ClientSipDynamicPortRange が 3 に設定されている場合、クライアント メディアでは 7100、7101、7102 の 3 ポートを使用できます。 |
ClientVideoPort |
省略可能 |
System.UInt16 |
クライアントのビデオに使用する開始ポート番号を表します。ClientVideoPort は、1024 ～ 65535 の範囲のポート番号値にする必要があります。既定値は 5350 です。 |
ClientVideoPortRange |
省略可能 |
System.UInt32 |
クライアントのビデオに使用可能なポートの合計数を示します。(既定値は 40 です。)クライアントのビデオで実際に使用されるポートを決定するには、この値と ClientVideoPort 値を使用します。たとえば、ClientVideoPort が 5350、ClientVideoPortRange が 3 に設定されている場合、クライアント ビデオでは 5350、5351、5352 の 3 ポートを使用できます。 |
CloudPollServicePrimaryUrl |
省略可能 |
System.String |
クラウドベース ポーリングを提供している組織用のプライマリ URL です。 |
CloudPollServiceSecondaryUrl |
省略可能 |
System.String |
クラウドベース ポーリングを提供している組織用のバックアップ URL です。 |
Confirm |
省略可能 |
System.Management.Automation.SwitchParameter |
コマンドの実行前に確認メッセージを表示します。 |
ConsoleDownloadExternalUrl |
省略可能 |
System.String |
外部ユーザーが、Lync Server 15 など、サポートされているクライアントをダウンロードできる URL です。この設定は、Microsoft Office Communicator 2007 R2 など、Lync Server プールにログオンしている従来のクライアントにのみ適用されます。 |
ConsoleDownloadInternalUrl |
省略可能 |
System.String |
内部ユーザーが、Lync 15 など、サポートされているクライアントをダウンロードできる URL です。この設定は、Microsoft Office Communicator 2007 R2 など、Lync Server プールにログオンしている従来のクライアントにのみ適用されます。 |
ContentGracePeriod |
省略可能 |
System.TimeSpan |
会議終了後、会議コンテンツがサーバーに残される期間を示します。ContentGracePeriod は、日.時:分:秒 の形式を使用して指定する必要があります。たとえば、コンテンツの猶予期間を 30 日間に設定するには、次の構文を使用します。-ContentGracePeriod 30.00:00:00。 コンテンツ猶予期間には、30 分間 (00:30:00) から 180 日間 (180.00:00:00) の範囲の値を設定できます。既定値は 15 日間 (15.00:00:00) です。 |
Force |
省略可能 |
System.Management.Automation.SwitchParameter |
コマンド実行中に発生する可能性のある、致命的ではないすべてのエラー メッセージを表示しないようにします。 |
HelpdeskExternalUrl |
省略可能 |
System.String |
会議中にヘルプをクリックした外部ユーザーが参照することになる URL。 |
HelpdeskInternalUrl |
省略可能 |
System.String |
会議中にヘルプをクリックした内部ユーザーが参照することになる URL。 |
InMemory |
省略可能 |
System.Management.Automation.SwitchParameter |
永続的な変更としてオブジェクトをコミットせずに、オブジェクト参照を作成します。このパラメーターを指定して呼び出したコマンドレットの出力を変数に割り当てる場合、オブジェクト参照のプロパティを変更し、コマンドレットに対応する Set- コマンドレットを呼び出してそれらの変更をコミットできます。 |
MaxBandwidthPerAppSharingServiceMb |
省略可能 |
System.UInt64 |
アプリケーション共有会議サービス用に設定する最大帯域幅 (MB) を示します。MaxBandwidthPerAppSharingServiceMb には、50 ～ 100000 の範囲の整数値を設定できます。既定値は 375 MB です。 |
MaxContentStorageMb |
省略可能 |
System.UInt16 |
会議コンテンツの記憶域として許可するファイル領域の最大値 (MB)。MaxContentStorageMb には、50 ～ 1024 (1 GB) の範囲の整数値を設定できます。既定値は 500 です。 |
MaxUploadFileSizeMb |
省略可能 |
System.UInt16 |
所定の会議で使用できるファイル (配布資料や PowerPoint スライドを含む) の最大合計サイズです。この設定は、通常、Microsoft Exchange Server での会議コンテンツのアーカイブ時に使用されます。最大アップロード ファイル サイズの設定によって、会議で使用されるコンテンツ (つまり、アーカイブが必要なコンテンツ) が Microsoft Exchange で構成されている最大ファイル サイズを超過しないようにできます。既定値は 500 MB です。 |
Organization |
省略可能 |
System.String |
会議をホストする組織の名前。 |
WhatIf |
省略可能 |
System.Management.Automation.SwitchParameter |
実際にコマンドを実行せずに、コマンドの実行結果がわかります。 |
入力の種類
なし。New-CsConferencingConfiguration コマンドレットは、パイプライン入力を受け入れません。
戻り値の種類
New-CsConferencingConfiguration コマンドレットは、Microsoft.Rtc.Management.WritableConfig.Settings.WebConf.ConfSettings オブジェクトの新しいインスタンスを作成します。