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