Get-CsArchivingConfiguration
上次修改主題的時間： 2012-03-23
傳回有關在您組織中如何 (或是否) 封存立即訊息 (IM) 工作階段的方法。
語法
Get-CsArchivingConfiguration [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]
Get-CsArchivingConfiguration [-Filter <String>] [-LocalStore <SwitchParameter>]
詳細描述
許多組織發現保留其使用者 (或所選取使用者的子集) 進行之所有 IM 工作階段的記錄非常有用。對於其他組織而言，保留這樣的記錄是必要的。例如，許多在金融界的組織依法規定須保留其所有的電子通訊副本。
就封存 IM 和網路會議工作階段而言，Microsoft Lync Server 2010 可讓您根據需求彈性地選擇。若您已部署了 封存伺服器，便能使用各種 CsArchivingConfiguration 指令程式來啟用及停用立即訊息的封存功能，以及管理您的封存資料庫。而在封存失敗時，您也可以藉由暫停 IM 來確保所有電子通訊均能納入記錄。
為了封存 IM 工作階段，您必須至少設定一個 封存伺服器。設定 封存伺服器 之後，您必須執行兩個額外的步驟。首先，需要在適當的範圍啟用封存 (如需詳細資訊，請參閱＜Set-CsArchivingConfiguration＞主題)。這可能是全域範圍；但是您也可以設定不同站台的自訂封存設定。
其次，您必須使用封存原則，指出將要封存其 IM 工作階段的使用者。如果您啟用封存，但未針對任何使用者指派應封存其 IM 工作階段的原則時，會發生什麼事？其實，並不會發生任何事：不會封存 IM 工作階段，除非使用需要封存 IM 工作階段的原則。
利用 Get-CsArchivingConfiguration 指令程式，您可決定如何在您組織中設定 IM 工作階段封存。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 Get-CsArchivingConfiguration Cmdlet：RTCUniversalUserAdmins、RTCUniversalServerAdmins。若要傳回指派給該指令程式的所有角色型存取控制 (RBAC) 角色清單 (包括您自己建立的任何自訂 RBAC 角色)，請在 Windows PowerShell 提示中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsArchivingConfiguration"}
參數
| 參數 | 必要 | 類型 | 描述 |
|---|---|---|---|
Identity |
選用 |
Xds 識別身份 |
表示您要傳回之封存設定集合的唯一識別碼。若要參考通用設定，請使用下列語法：-Identity global。若要參照在此站台範圍設定的集合，請使用如下語法：-Identity site:Redmond。請注意，在指定 Identity 時無法使用萬用字元。如果您必須使用萬用字元，請改為包含 Filter 參數。 如果未指定此參數，則 Get-CsArchivingConfiguration 會傳回一個使用於組織中所有封存組態設定的集合。 |
Filter |
選用 |
字串 |
可讓您使用萬用字元，以傳回一或多個封存組態設定的集合。若要傳回在站台範圍所設定之所有設定集合，請使用此語法：-Filter site:*。如果要傳回在其 Identity (您可篩選的唯一屬性) 某處具有字串值 "Canada" 的所有設定集合，請使用此語法：-Filter "*Canada*"。 |
LocalStore |
選用 |
切換參數 |
從 中央管理存放區 的本機複本擷取封存組態資料，而非從 中央管理存放區 本身擷取。 |
輸入類型
無。Get-CsArchivingConfiguration 不會接受管線傳送的資料。
傳回類型
Get-CsArchivingConfiguration 會傳回 Microsoft.Rtc.Management.WritableConfig.Settings.Archiving.ArchivingSettings 物件的執行個體。
範例
-------------------------- 範例 1 --------------------------
Get-CsArchivingConfiguration
範例 1 所示的命令會傳回您組織中使用之所有封存組態設定的集合。
-------------------------- 範例 2 --------------------------
Get-CsArchivingConfiguration -Identity site:Redmond
在上述範例中，Identity 參數是用來將傳回的封存組態設定集合限制於 Identity 為 site:Redmond 的那些設定。
-------------------------- 範例 3 --------------------------
Get-CsArchivingConfiguration -Filter site:*
在範例 3 中，Filter 參數是用來將傳回的封存組態設定集合，限制為已在站台範圍進行設定的相關設定。參數值 "site:*" 可將傳回的項目限制為 Identity 是以字串值 "site:" 開頭的項目。
-------------------------- 範例 4 --------------------------
Get-CsArchivingConfiguration | Where-Object {$_.EnableArchiving -ne "None"}
這個範例會使用 Get-CsArchivingConfiguration，傳回已啟用於您組織之所有封存組態設定的集合。作法是，命令會先呼叫 Get-CsArchivingConfiguration 且不用任何參數，以傳回您所有封存組態設定的集合。接著將該集合傳送給 Where-Object 指令程式，由它套用篩選，將傳回的資料限於 EnableArchiving 屬性等於 "None" 的集合。若將 EnableArchiving 設定為 "None"，則會停用封存。若將這個屬性設定為任何其他值 ("IMOnly" 或 "ImAndWebConf")，則表示啟用該封存。