Get-CsArchivingPolicy
上次修改主題的時間： 2012-03-23
傳回有關立即訊息 (IM) 工作階段封存原則的資訊。封存原則可讓您封存內部使用者之間和/或內部使用者與外部使用者之間發生的所有 IM 及 Web 會議工作階段。
語法
Get-CsArchivingPolicy [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]
Get-CsArchivingPolicy [-Filter <String>] [-LocalStore <SwitchParameter>]
詳細描述
許多組織都發現保留其使用者參與之所有 IM 工作階段的封存很有用處；有些組織則是依法保留此類封存。您必須執行兩項步驟，才能使用 Microsoft Lync Server 2010 封存 IM 工作階段。首先，您需要使用 Set-CsArchivingConfiguration 指令程式，在通用和/或網站範圍啟用封存。這可讓您能夠封存 IM 工作階段，不過，它不會自動開始封存這些工作階段。
但是，若要實際儲存 IM 工作階段的文字記錄，您必須完成步驟 2：建立一或多個 IM 工作階段封存原則。這些原則會決定哪些使用者可記錄 IM 工作階段，以及要封存哪些類型的 IM 工作階段 (內部和/或外部)。內部 IM 工作階段是指，其中的所有參與者都是經過驗證的使用者，他們在組織內擁有 Active Directory 帳戶；外部 IM 工作階段是指，其中至少有一位參與者是未驗證的使用者，他們在組織內沒有 Active Directory 帳戶。您可以選擇只封存內部工作階段、只封存外部工作階段，或是同時封存內部和外部工作階段。
您可以將封存原則 (使用 New-CsArchivingPolicy 指令程式建立) 指派至通用網站或網站範圍。此外，這些原則還可以指派至個別使用者範圍；也就是說，您可以建立原則，然後將其套用至特定使用者或特定一組使用者。例如，您的通用原則可能會封存所有使用者的內部 IM 工作階段。此外，您可以建立第二個原則 (這個原則會封存內部和外部工作階段)，然後將該原則套用至銷售人員。因為個別使用者原則的優先順序高於通用和網站原則，因此銷售人員的成員將會封存其所有 IM 工作階段。其他使用者 (也就是不在銷售部門且不受銷售原則影響的使用者) 就只會封存其內部 IM 工作階段。
Get-CsArchivingPolicy 指令程式提供一種方式，讓您傳回已設定為在組織中使用之封存原則的相關資訊。請記住，只有當通用或站台範圍已啟用 IM 工作階段封存時，才會強制執行這些原則。若要判斷是否已啟用 IM 工作階段封存，請使用 Get-CsArchivingConfiguration 指令程式。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 Get-CsArchivingPolicy Cmdlet：RTCUniversalUserAdmins、RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsArchivingPolicy"}
參數
| 參數 | 必要 | 類型 | 說明 |
|---|---|---|---|
Identity |
選用 |
Xds 識別身份 |
要傳回之封存原則的唯一識別碼。若要參考通用原則，請使用此語法：-Identity global。若要參考網站原則，請使用類似如下的語法：-Identity site:Redmond。若要參考個別使用者原則，請使用類似如下的語法：-Identity RedmondArchivingPolicy。如果省略此參數，則會傳回設定為在組織中使用的所有封存原則。 |
Filter |
選用 |
字串 |
可讓您在指示要傳回的原則 (或多個原則) 時使用萬用字元。例如，若要傳回在網站範圍設定的所有原則，請使用以下語法：-Filter "site:*"。這會傳回 Identity 開頭為字串值 "site:" 的任何原則 (您篩選可依據的唯一內容)。若要傳回具有開頭為 "Sales" 之 Identity 的所有個別使用者原則集合，請使用以下語法：-Filter "Sales*"。 |
LocalStore |
選用 |
切換參數 |
從中央管理存放區的本機複本擷取封存原則資料，而非從中央管理存放區本身擷取。 |
輸入類型
無。Get-CsArchivingPolicy 不接受管線傳送的輸入。
傳回類型
Get-CsArchivingPolicy 會傳回 Microsoft.Rtc.Management.WritableConfig.Policy.Im.IMArchivingPolicy 物件的執行個體。
範例
-------------------------- 範例 1 --------------------------
Get-CsArchivingPolicy
範例 1 呼叫 Get-CsArchivingPolicy 且不使用任何參數。如此會傳回組織中目前使用之所有封存原則的集合。
-------------------------- 範例 2 --------------------------
Get-CsArchivingPolicy -Identity site:Redmond
在範例 2 中，Get-CsArchivingPolicy 用來傳回 Identity 為 site:Redmond 的封存原則。由於識別身分必須是唯一的，因此這個命令一律傳回最多一個原則。
-------------------------- 範例 3 --------------------------
Get-CsArchivingPolicy -Filter tag:*
以上的命令會傳回已經在個別使用者範圍設定之所有封存原則的集合。加入 Filter 參數及篩選值 "tag:*" 可完成這個工作。該篩選值會指示 Get-CsArchivingPolicy 只傳回其 Identity 開頭字串值為 "tag:" 的原則。
-------------------------- 範例 4 --------------------------
Get-CsArchivingPolicy | Where-Object {$_.ArchiveInternal -eq $False}
範例 4 會傳回已停用內部 IM 工作階段封存的所有封存原則集合。若要這樣做，首先會使用 Get-CsArchivingPolicy 來傳回目前使用中之所有封存原則的集合。接著，該集合會傳送到 Where-Object 指令程式。然後，Where-Object 會套用篩選，以將傳回的資料限制為 ArchiveInternal 屬性設為 False 的原則。
-------------------------- 範例 5 --------------------------
Get-CsArchivingPolicy | Where-Object {$_.ArchiveInternal -eq $False -and $_.ArchiveExternal -eq $False}
範例 5 類似於範例 4；不過，在此例中，此命令會傳回同時停用內部及外部封存的所有封存原則。若要完成這個工作，首先會使用 Get-CsArchivingPolicy 來傳回目前使用中之所有封存原則的集合。接著，該集合會傳送到 Where-Object，只挑出 ArchiveInternal 和 ArchiveExternal 內容都等於 False 的原則。-and 運算子會指示 Where-Object 只選取符合所有指定條件的原則。若要選取只符合一個 (或兩個) 所指定準則的原則，請使用 –or 運算子：
Where-Object {$_.ArchiveInternal -eq $False -or $_.ArchiveExternal -eq $False}