Set-CsConferencingConfiguration
上次修改主題的時間: 2012-04-23
修改現有的會議組態設定集合。會議設定決定諸如允許的會議內容和講義大小上限、內容寬限期 (即刪除內容前的儲存時間),以及支援用戶端的內部和外部下載 URL 等事項。
語法
Set-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>] [-Confirm [<SwitchParameter>]] [-ConsoleDownloadExternalUrl <String>] [-ConsoleDownloadInternalUrl <String>] [-ContentGracePeriod <TimeSpan>] [-Force <SwitchParameter>] [-HelpdeskExternalUrl <String>] [-HelpdeskInternalUrl <String>] [-MaxBandwidthPerAppSharingServiceMb <UInt64>] [-MaxContentStorageMb <UInt16>] [-Organization <String>] [-WhatIf [<SwitchParameter>]]
Set-CsConferencingConfiguration [-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>] [-Confirm [<SwitchParameter>]] [-ConsoleDownloadExternalUrl <String>] [-ConsoleDownloadInternalUrl <String>] [-ContentGracePeriod <TimeSpan>] [-Force <SwitchParameter>] [-HelpdeskExternalUrl <String>] [-HelpdeskInternalUrl <String>] [-Instance <PSObject>] [-MaxBandwidthPerAppSharingServiceMb <UInt64>] [-MaxContentStorageMb <UInt16>] [-Organization <String>] [-WhatIf [<SwitchParameter>]]
詳細描述
對於會議而言,管理與系統管理會分別以兩組指令程式進行。如果您想要管理使用者能做與不能做的事情 (例如,使用者是否可以邀請匿名參與者加入會議、使用者是否可以在會議內進行應用程式共用,或使用者是否可以在會議內傳輸檔案),則需使用 CsConferencingPolicy 指令程式。
除了管理使用者活動之外,系統管理員還需要管理 Web 會議服務。例如,系統管理員需要能夠執行一些動作,例如指定配置給單一會議的內容儲存量上限,以及指定自動刪除該會議內容之前的寬限期。他們也需要能夠指定諸如應用程式共用及檔案傳輸這類活動使用的連接埠。
後面的活動是使用 CsConferencingConfiguration 指令程式來管理的。這些指令程式可讓您管理實際伺服器本身。 CsConferencingConfiguration 指令程式 (可以套用至通用、站台及服務範圍) 雖然不能用來指定使用者是否可在會議期間共用應用程式,但是可以在允許應用程式共用時,用來指出該活動應該使用哪些連接埠。同樣地,指令程式也可讓您指定一些事項,例如儲存限制和期限,以及可供使用者用來取得會議說明及資源的內部與外部 URL 指標。
安裝 Microsoft Lync Server 2010 時,系統會提供您一個會議組態設定集合 (全域集合)。如果您需要針對網站或服務建立自訂設定,可以使用 New-CsConferencingConfiguration 指令程式來進行作業。建立這些自訂設定後,您可以使用 Set-CsConferencingConfiguration 指令程式來修改其中的任何設定 (或修改通用集合)。
誰可以執行此 Cmdlet:下列群組的成員預設會獲授權可以在本機上執行 Set-CsConferencingConfiguration Cmdlet:RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色),請在 Windows PowerShell 提示字元中執行下列命令:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsConferencingConfiguration"}
參數
參數 | 必要 | 類型 | 描述 |
---|---|---|---|
Identity |
選用 |
Xds 識別身份 |
要修改之會議組態設定集合的唯一識別碼。若要參照全域集合,請使用下列語法:-Identity global。若要參照在此網站範圍設定的集合,請使用如下語法:-Identity "site:Redmond"。若要在服務範圍內參照某個集合,請使用下列語法:-Identity "service:ConferencingServer:atl-cs-001.litwareinc.com"。 Web 會議服務是唯一能主控這些組態設定的服務。 若未指定此參數,則 Set-CsConferencingConfiguration 將會自動修改通用設定。 |
Instance |
選用 |
ConfSettings 物件 |
允許您將物件參照傳遞給 Cmdlet,而不設定個別參數值。 |
ClientAppSharingPort |
選用 |
整數 |
代表用於應用程式共用的起始連接埠號碼。ClientAppSharingPort 必須是介於 1024 到 65535 之間 (包括 1024 和 65535) 的連接埠號碼值。預設值為 5350。 |
ClientAppSharingPortRange |
選用 |
整數 |
表示可供應用程式共用使用的連接埠總數 (預設值為 40)。若要決定實際上用於應用程式共用的連接埠,請使用這個值和 ClientAppSharingPort 值。例如,如果將 ClientAppSharingPort 設為 5350、將 ClientAppSharingPortRange 設為 3,則下列 3 個連接埠都可供應用程式共用使用:5350; 5351; 5352. |
ClientAudioPort |
選用 |
整數 |
代表用於用戶端音訊的起始連接埠號碼。ClientAudioPort 必須是介於 1024 到 65535 之間 (包括 1024 和 65535) 的連接埠號碼值。預設值為 5350。 |
ClientAudioPortRange |
選用 |
整數 |
表示可供用戶端音訊使用的連接埠總數 (預設值為 40)。若要決定實際上用於用戶端音訊的連接埠,請使用這個值和 ClientAudioPort 值。例如,如果將 ClientAudioPort 設為 5350、將 ClientAudioPortRange 設為 3,則下列 3 個連接埠都可供用戶端音訊使用:5350; 5351; 5352. |
ClientFileTransferPort |
選用 |
整數 |
代表用於檔案傳輸的起始連接埠號碼。ClientFileTransferPort 必須是介於 1024 到 65535 之間 (包括 1024 和 65535) 的連接埠號碼值。預設值為 5350。 |
ClientFileTransferPortRange |
選用 |
整數 |
表示可供檔案傳輸使用的連接埠總數 (預設值為 40)。若要決定實際上用於檔案傳輸的連接埠,請使用這個值和 ClientFileTransferPort 值。例如,如果將 ClientFileTransferPort 設為 5350、將 ClientFileTransferPortRange 設為 3,則下列 3 個連接埠都可供檔案傳輸使用:5350; 5351; 5352. |
ClientMediaPort |
選用 |
整數 |
代表用於用戶端媒體的起始連接埠號碼。此參數適用於 Microsoft Office Communicator 2007 R2 用戶端。ClientMediaPort 必須是介於 1024 到 65535 (包括 1024 和 65535) 之間的連接埠號碼值。預設值為 5350。 |
ClientMediaPortRange |
選用 |
整數 |
表示可供用戶端媒體使用的連接埠總數 (預設值為 40)。此參數適用於 Office Communicator 2007 R2 用戶端。若要決定實際上用於用戶端媒體的連接埠,請使用這個值和 ClientMediaPort 值。例如,如果將 ClientMediaPort 設為 5350、將 ClientMediaPortRange 設為 3,則下列三個連接埠都可供用戶端媒體使用:5350; 5351; 5352。 |
ClientMediaPortRangeEnabled |
選用 |
布林值 |
設為 True 時,用戶端將使用指定的連接埠範圍來傳輸媒體流量。設為 False (預設值) 時,系統會使用連接埠 1024 到連接埠 65535 之間任何可用的連接埠來容納媒體流量。 |
ClientSipDynamicPort |
選用 |
整數 |
代表用於 SIP 流量的起始連接埠號碼。ClientSipDynamicPort 必須是介於 1024 到 65535 之間 (包括 1024 和 65535) 的連接埠號碼值。預設值為 7100。 |
ClientSipDynamicPortRange |
選用 |
整數 |
表示可供 SIP 流量使用的連接埠總數 (預設值為 3)。若要決定實際上用於 SIP 流量的連接埠,請使用這個值和 ClientSipDynamicPort 值。例如,如果將 ClientSipDynamicPort 設為 7100、將 ClientSipDynamicPortRange 設為 3,則下列 3 個連接埠都可供用戶端媒體使用:7100; 7101; 7102. |
ClientVideoPort |
選用 |
整數 |
代表用於用戶端視訊的起始連接埠號碼。ClientVideoPort 必須是介於 1024 到 65535 之間 (包括 1024 和 65535) 的連接埠號碼值。預設值為 5350。 |
ClientVideoPortRange |
選用 |
整數 |
表示可供用戶端視訊使用的連接埠總數 (預設值為 40)。若要決定實際上用於用戶端視訊的連接埠,請使用這個值和 ClientVideoPort 值。例如,如果將 ClientVideoPort 設為 5350、將 ClientVideoPortRange 設為 3,則下列 3 個連接埠都可供用戶端視訊使用:5350; 5351; 5352. |
ConsoleDownloadExternalUrl |
選用 |
字串 |
供外部使用者下載支援 Microsoft Lync 2010 等用戶端的 URL。請注意,此設定僅適用於登入 Lync Server 集區的舊版用戶端 (例如 Microsoft Office Communicator 2007 R2)。 |
ConsoleDownloadInternalUrl |
選用 |
字串 |
供內部使用者下載支援 Microsoft Lync 2010 等用戶端的 URL。請注意,此設定僅適用於登入 Lync Server 集區的舊版用戶端 (例如 Microsoft Office Communicator 2007 R2)。 |
ContentGracePeriod |
選用 |
時間範圍 |
表示會議結束後,會議內容存留在伺服器中的時間。ContentGracePeriod 必須以 Days.Hours:Minutes:Seconds 的格式加以指定。例如,若要將內容寬限期設為 30 天,請使用下列語法:-ContentGracePeriod 30.00:00:00。 您可以將內容寬限期設為 30 分鐘 (00:30:00) 到 180 天 (180.00:00:00) 之間的任何值。預設值為 15 天 (15.00:00:00)。 |
HelpdeskExternalUrl |
選用 |
字串 |
外部使用者在會議中點擊 [說明] 時,系統會引導該使用者前往的 URL。 |
HelpdeskInternalUrl |
選用 |
字串 |
內部使用者在會議中點擊 [說明] 時,系統會引導該使用者前往的 URL。 |
MaxBandwidthPerAppSharingServiceMb |
選用 |
整數 |
表示為 應用程式共用會議服務預留的頻寬上限 (MB)。您可以將 MaxBandwidthPerAppSharingServiceMb 設為 50 到 100000 之間 (包括 50 和 100000) 的任何整數值。預設值為 375 MB。 |
MaxContentStorageMb |
選用 |
整數 |
允許供儲存會議內容的檔案空間上限 (MB)。您可以將 MaxContentStorageMb 設為 50 到 1024 (1 GB) 之間 (包括 50 和 1024) 的任何整數值。預設值為 500 MB。 |
Organization |
選用 |
字串 |
主控會議之組織的名稱。 |
Force |
選用 |
切換參數 |
隱藏顯示當執行命令時可能發生的任何非嚴重錯誤訊息。 |
WhatIf |
選用 |
切換參數 |
描述執行命令後的結果,但無須實際執行命令。 |
Confirm |
選用 |
切換參數 |
執行命令前先要求您確認。 |
輸入類型
Microsoft.Rtc.Management.WritableConfig.Settings.WebConf.ConfSettings 物件。 Set-CsConferencingConfiguration 接受會議組態物件管線傳送的執行個體。
傳回類型
Set-CsConferencingConfiguration 不會傳回值或物件。反之,指令程式會設定 Microsoft.Rtc.Management.WritableConfig.Settings.WebConf.ConfSettings 物件的執行個體。
範例
範例 1
Set-CsConferencingConfiguration -Identity global -Organization Litwareinc
在範例 1 中, Set-CsConferencingConfiguration 會修改會議組態設定的通用執行個體;在此案例中,該命令可將 Organization 內容的值設為 Litwareinc。您可以藉由加上 Organization 參數再加上 Litwareinc 組織名稱來完成作業。
範例 2
Get-CsConferencingConfiguration | Set-CsConferencingConfiguration -Organization Litwareinc
範例 2 是第一個範例的延伸。在這種情況下,此命令會針對目前使用的會議組態設定修改各集合的 Organization 屬性值。為達成此目的,此命令會先使用 Get-CsConferencingConfiguration 來擷取所有會議組態設定的集合。接著,會將這個集合傳送至 Set-CsConferencingConfiguration,這會提取集合中的每個項目,並將 Organization 屬性的值變更為 Litwareinc。
範例 3
Get-CsConferencingConfiguration -Filter site:* | Set-CsConferencingConfiguration -MaxContentStorageMb 50
範例 3 所示的命令可針對所有已套用至網站範圍的會議組態設定變更 MaxContentStorageMb 屬性的值。為達成此目的,此命令需要先呼叫 Get-CsConferencingConfiguration 搭配 Filter 參數。篩選值 "site:*" 可讓系統只傳回 Identity 開頭為 "site:" 等字元的設定 才會傳回。接著,篩選過的集合會傳送至 Set-CsConferencingConfiguration,這會將集合中每一個項目的 MaxContentStorageMB 屬性值變更為 50。
範例 4
Get-CsConferencingConfiguration | Where-Object {$_.MaxContentStorageMb -gt 100} | Set-CsConferencingConfiguration -MaxContentStorageMB 100
在範例 4 中,系統會修改所有允許儲存 100 MB 以上之內容的會議組態設定,將允許儲存的內容上限設為 100 MB。為了執行此作業,該命令會先在未搭配任何參數的情況下呼叫 Get-CsConferencingConfiguration,以傳回目前使用中的所有會議組態設定的集合。接著,系統會將這個集合傳送到 Where-Object 指令程式,這會挑出 MaxContentStorageMB 屬性大於 100 的設定。然後,這個篩選過的集合會傳送到 Set-CsConferencingConfiguration,以取得集合中的各一個項目,然後再將 MaxContentStorageMb 屬性的值設為 100。
範例 5
Set-CsConferencingConfiguration -Identity site:Redmond -ContentGracePeriod "22:00:00"
上述命令可擷取 Redmond 網站 (-Identity site:Redmond) 的會議組態設定,並且會修改 ContentGracePeriod 屬性的值,將寬限期設為 22 小時 (22 小時:00 分鐘:00 秒) 的 A/V Edge 組態設定。
範例 6
Get-CsConferencingConfiguration | Where-Object {$_.Organization -ne "Fabrikam"} | Set-CsConferencingConfiguration -Organization Litwareinc
在範例 6 中,系統會修改所有未將 Fabrikam 列為 Organization 的會議組態設定。特別是,系統會將 Litwareinc 指派為這些設定的新組織。為了達到這項目的,該命令會先呼叫 Get-CsConferencingConfiguration 且不搭配任何參數;如此會傳回組織中目前使用的所有會議設定之集合。接著,系統會將這個集合傳送到 Where-Object 指令程式;該指令程式會選取所有 Organization 屬性不等於 (-ne) Fabrikam 的設定。然後,這個篩選過的集合會傳送至 Set-CsConferencingConfiguration。 Set-CsConferencingConfiguration 會取得集合中的每一個項目,並將 Organization 屬性的值變更為 Litwareinc。