Get-CsConferencingPolicy
上次修改主題的時間: 2012-03-23
傳回已設定為在組織中使用之會議原則的相關資訊。會議原則會決定可在會議中使用的功能;包括會議是否可以加入 IP 音訊和視訊到可出席會議的人數上限的各種設定。
語法
Get-CsConferencingPolicy [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]
Get-CsConferencingPolicy [-Filter <String>] [-LocalStore <SwitchParameter>]
詳細描述
會議是 Microsoft Lync Server 2010 中十分重要的部分,其讓使用者群組可以共同在線上檢視投影片和視訊、共用應用程式、交換檔案,甚至進行通訊及共同作業。
對於系統管理員來說,最重要的是保有對於會議與會議設定的控制權。在某些情況下,可能會有安全性顧慮:預設任何人 (包括未驗證的使用者) 都可以參與會議,並儲存會議期間散佈的任何投影片或講義。在某些情況下,可能會有頻寬顧慮:有許多同時進行的會議,每個會議都包含數百位參與者且都會使用視訊播放和檔案共用,而這可能會導致您的網路出現問題。此外,有時可能也會有法律顧慮。例如,會議參與者預設可以在共用內容上加上註解;不過封存會議時並不會儲存這些註解。如果您的組織需要保留所有電子通訊的記錄,您可能會想要停用註解。
當然,需要管理會議設定是一回事,實際管理這些設定又是另一回事。在 Lync Server 2010 中,會議是使用會議原則來管理。(在此軟體的舊版中,這些稱為會議原則)。但如上述,會議原則會判斷可在會議中使用的特性與功能;範圍從會議是否可包含 IP 音訊和視訊到可出席會議的人數上限都涵蓋在內。會議原則可以在全域範圍、網站範圍或個別使用者範圍設定。這可為系統管理員在決定哪些使用者可以使用哪些功能時提供了很大的彈性。
Get-CsConferencingPolicy 指令程式提供一種方式,讓您傳回已設定為在組織中使用之所有會議原則的相關資訊。
誰可以執行此 Cmdlet:下列群組的成員預設會獲授權可以在本機上執行 Get-CsConferencingPolicy Cmdlet:RTCUniversalUserAdmins、RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色),請在 Windows PowerShell 提示字元中執行下列命令:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsConferencingPolicy"}
參數
參數 | 必要 | 類型 | 說明 |
---|---|---|---|
Identity |
選用 |
Xds 識別碼 |
要擷取之會議原則的唯一識別碼。會議原則可以在通用、網站或個別使用者範圍設定。若要擷取通用原則,請使用此語法:-Identity global。若要擷取網站原則,請使用類似如下的語法:-Identity site:Redmond。若要擷取個別使用者原則,請使用類似如下的語法:-Identity SalesConferencingPolicy。 如果未加入這個參數,Get-CsConferencingPolicy 將會傳回設定用於組織之所有會議原則的集合。 請注意,指定 Identity 時不允許使用萬元字元。如果您要在指定會議原則時使用萬用字元,請使用 Filter 參數。 |
Filter |
選用 |
字串 |
可讓您在指定要傳回的原則時使用萬用字元。例如,以下語法會傳回在網站範圍設定的所有原則:-Filter "site:*"。若要傳回在個別使用者範圍設定的所有原則集合,請使用以下語法:-Filter "tag:*"。 |
LocalStore |
選用 |
切換參數 |
從中央管理存放區的本機複本擷取會議原則資料,而非從中央管理存放區本身擷取。 |
輸入類型
無。Get-CsConferencingPolicy 不接受管線傳送的輸入。
傳回類型
Get-CsConferencingPolicy 會傳回 Microsoft.Rtc.Management.WritableConfig.Settings.Meeting.MeetingPolicy 物件的執行個體。
範例
-------------------------- 範例 1 --------------------------
Get-CsConferencingPolicy
上述範例傳回設定用於組織的所有會議原則的集合。
-------------------------- 範例 2 --------------------------
Get-CsConferencingPolicy -Identity Global
在範例 2 中,Identity 參數用於將擷取的資訊限制為其 Identity 等於 Global 的會議原則。原則 Identity 必須是唯一的,這個命令才會傳回單一原則:通用會議原則。
-------------------------- 範例 3 --------------------------
Get-CsConferencingPolicy -Filter tag:*
以上的範例使用 Filter 參數來傳回已經在個別使用者範圍設定之所有會議原則的集合 萬用字元值 "tag:*" 會告知 Windows PowerShell 將傳回的資料限制為 Identity 開頭為字串值 "tag:" 的會議原則。
-------------------------- 範例 4 --------------------------
Get-CsConferencingPolicy | Where-Object {$_.MaxMeetingSize -gt 100}
範例 4 會傳回其 MaxMeetingSize 屬性大於 100 之所有會議原則的集合。此命令會透過使用 Get-CsConferencingPolicy 指令程式傳回設定用於組織之所有會議原則的集合來開始。接著,該集合會傳送到 Where-Object 指令程式,以套用篩選,該篩選會將傳回的資料限制為 MaxMeetingSize 屬性大於 100 的原則。
-------------------------- 範例 5 --------------------------
Get-CsConferencingPolicy | Where-Object {$_.AllowExternalUsersToSaveContent -eq $True -and $_.AllowExternalUserControl -eq $True}
以上的命令會傳回符合以下兩個條件的所有會議原則:AllowExternalUsersToSaveContent 屬性等於 True,而且 AllowExternalUserControl 屬性也等於 True。若要這樣做,此命令會呼叫不含任何額外參數的 Get-CsConferencingPolicy;這樣會傳回設定用於組織之所有會議原則的集合。接著,該集合會傳送到 Where-Object,只挑出其中 AllowExternalUsersToSaveContent 和 AllowExternalUserControl 均為 True 的原則。-and 運算子會告知 Where-Object,物件必須符合所有指定的條件,才能傳回。
-------------------------- 範例 6 --------------------------
Get-CsConferencingPolicy | Where-Object {$_.AllowExternalUsersToSaveContent -eq $True -or $_.AllowExternalUserControl -eq $True}
範例 6 是範例 5 所示的命令變化。在此例中,該命令會傳回至少符合其中一個 (但不一定是兩個) 指定之條件的所有原則:AllowExternalUsersToSaveContent 屬性等於 True 和/或 AllowExternalUserControl 屬性等於 True。若要這樣做,此命令會呼叫不含任何額外參數的 Get-CsConferencingPolicy;這樣會傳回設定用於組織之所有會議原則的集合。接著,該集合會傳送到 Where-Object,只挑出其中 AllowExternalUsersToSaveContent 和/或 AllowExternalUserControl 等於 True 的原則。-or 運算子會告知 Where-Object,物件只必須符合其中一個指定的條件,就能傳回。