Set-CsArchivingPolicy
上次修改主題的時間: 2012-03-26
修改現有的立即訊息 (IM) 封存原則。封存原則可讓您封存所有 IM 工作階段和內部使用者之間舉行的會議;您還可以封存內部使用者和同盟夥伴之間進行的工作階段。
語法
Set-CsArchivingPolicy [-Identity <XdsIdentity>] [-ArchiveExternal <$true | $false>] [-ArchiveInternal <$true | $false>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Set-CsArchivingPolicy [-ArchiveExternal <$true | $false>] [-ArchiveInternal <$true | $false>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-WhatIf [<SwitchParameter>]]
詳細描述
許多組織發現保留使用者參與的所有 IM 工作階段封存很有幫助。其他組織則依法需保留這樣的封存。您必須執行兩項步驟,才能使用 Microsoft Lync Server 2010 封存 IM 工作階段。首先,您必須使用 Set-CsArchivingConfiguration 指令程式,通用和/或網站範圍啟用封存。這讓您可以封存 IM 工作階段;不過,它不會自動開始封存那些工作階段。
若要實際儲存 IM 工作階段的文字記錄,您必須完成步驟 2:建立一或多個封存原則。這些原則會決定哪些使用者要記錄其 IM 工作階段,以及要封存哪些類型的 IM 工作階段 (內部和/或外部)。內部 IM 工作階段是工作階段中,所有參與者都是擁有組織中 Active Directory 帳戶的已驗證使用者;外部 IM 工作階段是工作階段中,至少有一個參與者是沒有組織中 Active Directory 帳戶的未驗證使用者。您可以選擇只封存內部工作階段、只封存外部工作階段,或是同時封存內部和外部工作階段。
可將封存原則 (使用 New-CsArchivingPolicy 指令程式建立) 指派至通用網站或網站範圍。此外,可將這些原則指派給每個使用者範圍;這表示可先建立原則,然後將原則套用到特定使用者或一群使用者。例如,您可以擁有為全部使用者封存內部 IM 工作階段的通用原則。此外,您可以建立同時封存內部和外部工作階段的次要原則;然後只將次要原則套用到您自己的銷售人員。因為每個使用者原則優先於通用和網站原則,所以銷售人員的成員可以封存全部的 IM 工作階段。其他使用者 (也就是不在銷售部門且不受銷售原則影響的使用者) 就只會封存其內部 IM 工作階段。
Set-CsArchivingPolicy 指令程式可讓您修改目前用於組織的任何 IM 工作階段封存原則的屬性值。
誰可以執行此 Cmdlet:下列群組的成員預設會獲授權可以在本機上執行 Set-CsArchivingPolicy Cmdlet:RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色),請在 Windows PowerShell 提示字元中執行下列命令:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsArchivingPolicy"}
參數
參數 | 必要 | 類型 | 描述 |
---|---|---|---|
Identity |
選用 |
Xds 識別身份 |
要修改之封存原則的唯一識別碼。可將封存原則設定在通用、網站或每個使用者範圍。若要修改通用原則,請使用此語法:-Identity global。若要修改網站原則,請使用類似下列的語法:-Identity site:Redmond。若要修改每個使用者原則,請使用類似下列的語法:-Identity SalesArchivingPolicy。如果未指定此參數,會修改通用原則。 指定 Identity 時,不得使用萬用字元。 |
Instance |
選用 |
IMArchivingPolicy 物件 |
允許您將物件參照傳遞給 Cmdlet,而不設定個別參數值。 |
ArchiveExternal |
選用 |
布林值 |
指出是否封存外部 IM 工作階段(外部 IM 工作階段至少有一位參與者是未經過驗證的使用者,他們在組織內沒有 Active Directory 帳戶)。預設值為 False,表示不封存包含外部使用者的 IM 工作階段。 |
ArchiveInternal |
選用 |
布林值 |
指出是否封存內部 IM 工作階段(內部 IM 工作階段的所有參與者都是經過驗證的使用者,他們在組織內擁有 Active Directory 帳戶)。預設值為 False,表示不封存內部 IM 工作階段。 |
Description |
選用 |
字串 |
可讓系統管理員提供關於原則的其他文字。例如,可使用 Description 屬性詳細說明原則應套用到哪些使用者。 |
Force |
選用 |
切換參數 |
隱藏顯示當執行命令時可能發生的任何非嚴重錯誤訊息。 |
WhatIf |
選用 |
切換參數 |
描述執行命令後的結果,但無須實際執行命令。 |
Confirm |
選用 |
切換參數 |
執行命令前先要求您確認。 |
輸入類型
Microsoft.Rtc.Management.WritableConfig.Policy.IM.IMArchivingPolicy 物件。Remove-CsArchivingPolicy 接受管線傳送的封存原則物件輸入。
傳回類型
Set-CsArchivingPolicy 不會傳回值或物件。而指令程式會設定 Microsoft.Rtc.Management.WritableConfig.Settings.Policy.IM.IMArchivingPolicy 物件的執行個體。
範例
-------------------------- 範例 1 --------------------------
Set-CsArchivingPolicy -Identity global -ArchiveInternal $True
在這個範例中,Set-CsArchivingPolicy 可用來修改通用封存原則。在這種情況下,ArchiveInternal 屬性是設為 True。
-------------------------- 範例 2 --------------------------
Get-CsArchivingPolicy | Set-CsArchivingPolicy -ArchiveInternal $True
範例 2 是範例 1 所示的命令變化。不過,組織中的所有封存原則這次都設為允許封存 IM 工作階段。為了執行這項作業,命令會先使用 Get-CsArchivingPolicy 傳回目前使用中的所有 IM 工作階段封存原則之集合。該集合會傳送到 Set-CsArchivingPolicy;此指令程式會將每個原則的 ArchiveInternal 內容設為 True。