Grant-CsArchivingPolicy
上次修改主題的時間： 2012-03-23
可讓您指派立即訊息 (IM) 工作階段封存原則給使用者或使用者集合。這些原則讓您能夠封存內部使用者之間發生的所有 IM 工作階段，和/或封存內部使用者與外部夥伴之間發生的所有 IM 工作階段。
語法
Grant-CsArchivingPolicy -Identity <UserIdParameter> [-PolicyName <String>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-PassThru <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 工作階段。
Grant-CsArchivingPolicy 指令程式可用來指派個別使用者封存原則至使用者或指定的使用者集。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 Grant-CsArchivingPolicy Cmdlet：RTCUniversalUserAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Grant-CsArchivingPolicy"}
參數
| 參數 | 必要 | 類型 | 描述 |
|---|---|---|---|
Identity |
必要 |
Xds 識別身份 |
指出要將原則指派給哪一個使用者帳戶的 Identity。可以使用下列四種格式的其中一種來指定使用者識別：1) 使用者的 SIP 位址；2) 使用者主體名稱 (UPN)；3) 使用者的網域名稱和登入名稱，格式為 domain\logon (例如 litwareinc\kenmyer)；和 4) 使用者的 Active Directory 顯示名稱 (例如 Ken Myer)。也可以透過使用者的 Active Directory 辨別名稱來參考使用者識別。 此外，使用顯示名稱作為使用者 Identity 時，可以使用星號 (*) 萬用字元。例如，Identity "* Smith" 會傳回所有顯示名稱是以字串值 " Smith" 結束的使用者。 |
PolicyName |
必要 |
字串 |
要指派之原則的「名稱」。PolicyName 只是原則 Identity 減去範圍指示項 "tag:"。例如，含有 Identity 為 tag:Redmond 之原則的 PolicyName 等於 Redmond；含有 Identity 為 tag:RedmondArchivingPolicy 之原則的 PolicyName 等於 RedmondArchivingPolicy。 若要移除已指派給使用者的個別使用者原則，請將 PolicyName 設為 Null 值： -PolicyName $Null |
DomainController |
選用 |
字串 |
可讓您指定指派原則時連線的網域控制站。如果未包含此參數，指令程式會使用第一個可用的網域控制站。 |
PassThru |
選用 |
切換參數 |
如果存在，會使指令程式透過 Windows PowerShell 管線傳遞使用者物件 (或多個物件)。根據預設，Grant-CsArchivingPolicy 不會透過管線傳遞物件。 |
WhatIf |
選用 |
切換參數 |
描述執行命令後的結果，但無須實際執行命令。 |
Confirm |
選用 |
切換參數 |
執行命令前先要求您確認。 |
輸入類型
字串值或 Microsoft.Rtc.Management.ADConnect.Schema.ADUser 物件。Grant-CsArchivingPolicy 會接受代表使用者帳戶識別之字串值的管線傳送資料。此指令程式也接受已傳送的使用者物件輸入。
傳回類型
Grant-CsArchivingPolicy 不會傳回值或物件。而是指令程式會指派 Microsoft.Rtc.Management.WritableConfig.Policy.IM.ImArchivingPolicy object 物件的執行個體給使用者或使用者群組。但是，如果您包含 PassThru 參數，指令程式會傳回 Microsoft.Rtc.Management.ADConnect.Schema.OCSUserOrAppContact 的執行個體。
範例
-------------------------- 範例 1 ------------------------
Grant-CsArchivingPolicy -Identity "Ken Myer" -PolicyName RedmondArchivingPolicy
範例 1 中，封存原則 RedmondArchivingPolicy 被指派給顯示名稱為 "Ken Myer" 的使用者。請注意，使用 Grant-CsArchivingPolicy，Identity 屬性會參考使用者的 Identity，而不是封存原則的 Identity。而要指派的原則，則使用 PolicyName 參數指定；參數值為原則 Identity (減去 "tag:"prefix)。
-------------------------- 範例 2 ------------------------
Get-CsUser -OU "OU=Redmond,dc=litwareinc,dc=com" | Grant-CsArchivingPolicy -PolicyName RedmondArchivingPolicy
上述命令會將封存原則 RedmondArchivingPolicy 指派給 Redmond 組織單位 (OU) 內擁有帳戶的全部使用者。為了執行這項作業，使用 Get-CsUser 和 OU 參數以傳回 OU (辨別名稱為 "OU=Redmond,dc=litwareinc,dc=com") 內擁有帳戶的全部使用者集合。此集合會傳送給 Grant-CsArchivingPolicy，將 RedmondArchivingPolicy 指派給集合中的每一位使用者。
-------------------------- 範例 3 ------------------------
Get-CsUser -LdapFilter "l=Redmond" | Grant-CsArchivingPolicy -PolicyName RedmondArchivingPolicy
範例 3 所示的命令會將 RedmondArchivingPolicy 原則指派給在 Redmond 工作的每一位使用者。為了完成這項工作，會呼叫 Get-CsUser 搭配 LdapFilter 參數；LDAP 篩選值 "l=Redmond" 會傳回在 Redmond 城市工作之所有使用者的集合。(在 LDAP 的查詢語言中，l 是小寫 l，代表「地區」或城市的縮寫)。此集合會傳送給 Grant-CsArchivingPolicy，將 RedmondArchivingPolicy 指派給集合中的每一位使用者。
-------------------------- 範例 4 ------------------------
Get-CsUser -Filter {RegistrarPool -eq "atl-cs-001.litwareinc.com"} | Grant-CsArchivingPolicy -PolicyName RedmondArchivingPolicy
範例 4 中，會將 RedmondArchivingPolicy 原則指派給屬於 atl-cs-001.litwareinc.com 登錄器集區的所有使用者。為了執行這項作業，會先使用 Get-CsUser 以傳回已啟用 Lync Server 的全部使用者。接著此集合會被傳送到 Where-Object 指令程式，該指令程式只會選取擁有 RegistrarPool (等同於 atl-cs-001-litwareinc.com) 的使用者。然後，這個篩選過的集合會傳送到 Grant-CsArchivingPolicy，該指令程式會將 RedmondArchivingPolicy 原則指派給集合中的每個使用者。
-------------------------- 範例 5 ------------------------
Get-CsUser -Filter {ArchivingPolicy -eq "RedmondArchivingPolicy"} | Grant-CsArchivingPolicy -PolicyName "NorthAmericaArchivingPolicy"
範例 5 會尋找已指派 RedmondArchivingPolicy 原則的全部使用者，然後指派每一位使用者不同的原則：NorthAmericaArchivingPolicy。為了執行這項工作，會使用 Get-CsUser 以傳回已啟用 Lync Server 的全部使用者集合；Filter 參數和篩選值 {ArchivingPolicy -eq "RedmondArchivingPolicy"} 限制傳回的帳戶資料，其中 ArchivingPolicy 等於 "RedmondArchivingPolicy"。經過篩選的集合會被傳送到 Grant-CsArchivingPolicy，該指令程式會將 NorthAmericaArchivingPolicy 原則指派給集合中的每一位使用者。
-------------------------- 範例 6 ------------------------
Get-CsUser -Filter {ArchivingPolicy -eq "RedmondArchivingPolicy"} | Grant-CsArchivingPolicy -PolicyName $Null
範例 6 是範例 5 的變化；但是，這次是對先前已指派 RedmondArchivingPolicy 原則的使用者進行解除指派：搭配 PolicyName 等於 $Null 呼叫 Grant-CsArchivingPolicy，會移除先前指派的個別使用者原則。