Grant-CsPresencePolicy
上次修改主題的時間： 2012-03-23
將個別使用者顯示狀態原則授與使用者或使用者群組。
語法
Grant-CsPresencePolicy -Identity <UserIdParameter> [-PolicyName <String>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-PassThru <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
詳細描述
目前狀態資訊十分有價值，它可讓您知道連絡人是否可參與立即訊息交談。但同時，使用目前狀態資訊也是有代價的：目前狀態訂閱的愈多，則必須有更多專供更新目前狀態資訊使用的網路頻寬。如果您擔心網路頻寬的問題，可以限制每個人的目前狀態訂閱數。
CsPresencePolicy 指令程式可讓您管理目前狀態資訊兩個重要的層面：已提示訂閱者與類別目錄訂閱。在將您新增到另一個人的 Microsoft Lync 2010 連絡人清單後，為您設定的預設行為是會收到快顯通知來告知已將您新增到該清單中。一直到您將顯示的對話方塊關閉後，每個通知才能算作已提示訂閱者。目前狀態原則的 MaxPromptedSubscriber 屬性可讓您指定使用者可擁有的未解決通知對話方塊數目上限(如果使用者到達上限，就不會再收到新的連絡人通知 - 至少在某些對話方塊已解決前不會)。
類別目錄訂閱代表要求特定的資訊目錄，例如要求行事曆資訊的應用程式。MaxCategorySubscription 屬性可讓您設定使用者可擁有的類別目錄訂閱數限制。
Microsoft Lync Server 2010 之前版本的已提示訂閱者與類別目錄訂閱是通用管理的。透過 CsPresencePolicy 指令程式，您現在可以在全域範圍、站台範圍，甚至是個別使用者範圍管理目前狀態訂閱。這可讓您控制頻寬的使用，同時確保使用者能夠存取工作所需的目前狀態資訊。
建立個別使用者原則時，該原則並沒有自動指派給每個人。而是必須執行 Grant-CsPresencePolicy 指令程式，明確將個別使用者顯示狀態原則指派給使用者 (或使用者群組)。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 Grant-CsPresencePolicy Cmdlet：RTCUniversalUserAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Grant-CsPresencePolicy"}
參數
| 參數 | 必要 | 類型 | 描述 |
|---|---|---|---|
Identity |
必要 |
表示要指派顯示狀態原則之使用者帳戶的 Identity。可以使用下列四種格式的其中一種來指定使用者識別：1) 使用者的 SIP 位址；2) 使用者的使用者主體名稱 (UPN)；3) 使用者的網域名稱和登入名稱，格式為 domain\logon (如 litwareinc\kenmyer)；4) 使用者的 Active Directory 顯示名稱 (如 Ken Myer)。也可以使用使用者的 Active Directory 辨別名稱來指定使用者識別。 此外，使用顯示名稱作為使用者 Identity 時，可以使用星號 (*) 萬用字元。例如，Identity "* Smith" 會傳回所有顯示名稱是以字串 " Smith" 結束的使用者。 |
|
PolicyName |
必要 |
要指派之個別使用者原則的 Identity；例如：-PolicyName "RedmondPresencePolicy"。PolicyName 是原則 Identity 減去 "tag"：首碼。例如，Identity 為 "tag:NorthAmericaPresencePolicy" 的原則，其 PolicyName 等同於 "NorthAmericaPresencePolicy"。 |
|
DomainController |
選用 |
當指派原則時所要連絡之網域控制站的完整網域名稱 (FQDN)。例如：-DomainController atl-dc-001.litwareinc.com。 如果未指定，則當指派原則時 Grant-CsPresencePolicy 會與最近的可用網域控制站連絡。 |
|
PassThru |
選用 |
可讓您透過代表已指派原則的使用者之管線傳遞使用者物件。根據預設，Grant-CsPresencePolicy 指令程式不會透過管線傳遞物件。 |
|
WhatIf |
選用 |
描述執行命令後的結果，但無須實際執行命令。 |
|
Confirm |
選用 |
執行命令前先要求您確認。 |
輸入類型
字串值或 Microsoft.Rtc.Management.WritebleConfig.Policy.Presence.PresencePolicy 物件。Grant-CsPresencePolicy 接受代表使用者帳戶識別之管線傳送的字串值輸入。Cmdlet 也接受管線傳送的使用者物件輸入。
傳回類型
根據預設，Grant-CsPresencePolicy 不會傳回物件或值。但是，如果您包含 PassThru 參數，指令程式會傳回 Microsoft.Rtc.Management.ADConnect.Schema.OCSUserOrAppContact 的執行個體。
範例
-------------------------- 範例 1 ------------------------
Grant-CsPresencePolicy -Identity "Ken Myer" -PolicyName "RedmondPresencePolicy"
範例 1 所示的命令會將個別使用者顯示狀態原則 RedmondPresencePolicy 指派給單一使用者：含有 Identity Ken Myer 的使用者。
-------------------------- 範例 2 ------------------------
Get-CsUser -OU "OU=Redmond,dc=litwareinc,dc=com" | Grant-CsPresencePolicy -PolicyName "RedmondPresencePolicy"
在範例 2 中，目前狀態原則 RedmondPresencePolicy 會指派給在 Active Directory 網域服務 (AD DS) 之 Redmond OU 中擁有帳戶的所有使用者。為達成此目的，命令會先使用 Get-CsUser 和 OU 參數，傳回 Redmond OU (OU=Redmond,dc=litwareinc,dc=com) 中找到之所有使用者帳戶的集合。此集合接著會傳送給 Grant-CsPresencePolicy，將 RedmondPresencePolicy 原則指派給集合中的每一位使用者。
-------------------------- 範例 3 ------------------------
Get-CsUser -LDAPFilter "l=Redmond" | Grant-CsPresencePolicy -PolicyName "RedmondPresencePolicy"
上述命令會將原則 RedmondPresencePolicy 指派給在 Redmond 市工作的所有使用者。為了執行這項工作，命令會先使用 Get-CsUser 和 LDAPFilter 參數，傳回在 Redmond 工作之所有使用者的集合；篩選值 "l=Redmond" 會將傳回的資料限制於在 Redmond 的使用者。(在 LDAP 的查詢語言中，l 是小寫 l，代表「地區」)。此集合會傳送給 Grant-CsPresencePolicy，將 RedmondPresencePolicy 指派給集合中的每一位使用者。
-------------------------- 範例 4 ------------------------
Get-CsUser -LDAPFilter "l=Redmond" | Grant-CsPresencePolicy -PolicyName $Null
範例 4 所示的命令會解除指派所有指派給在 Redmond 工作之使用者的個別使用者目前狀態原則。透過將 PolicyName 參數設為 Null 值 ($Null) 來呼叫 Grant-CsPresencePolicy，讓該指令程式移除任何受命令影響之使用者的個別使用者顯示狀態原則。