Grant-CsClientVersionPolicy
上次修改主題的時間： 2012-03-23
在通用、站台、服務、或個別使用者範圍指派用戶端版本原則。用戶端版本原則可讓您指定哪些用戶端 (如 Microsoft Office Communicator 2007 R2) 能登入您的 Microsoft Lync Server 2010 系統。
語法
Grant-CsClientVersionPolicy -Identity <UserIdParameter> [-PolicyName <String>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-PassThru <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
詳細描述
用戶端版本原則代表用戶端版本規則的集合；而用戶端版本規則用於決定允許登入 Lync Server 2010 的用戶端應用程式。當使用者嘗試登入 Lync Server 2010 時，該使用者的用戶端應用程式會傳送 SIP 標頭給伺服器，這個標頭包含與應用程式本身有關的詳細資訊，包括軟體的主要版本和組建編號。然後系統會根據用戶端版本規則的集合，檢查 SIP 標頭所含的版本資訊，查看是否有任何規則要套用至該特定應用程式。如果有這樣的規則，Lync Server 2010 就會採取此規則指定的行動。例如，規則可能會告訴 Lync Server 2010 允許登入、封鎖登入，或者允許登入，但接著將用戶端應用程式以無訊息方式更新為最新版本 (例如，將 Office Communicator 2007 R2 更新為 Microsoft Lync 2010)。
用戶端版本原則 (可套用至全域範圍、站台範圍、服務範圍 (僅登錄器服務)，或個別使用者範圍)，可讓您在決定哪些用戶端應用程式可用來存取系統時，擁有彈性。例如，您可能想防止使用者使用 Communicator 2007 R2 登入 Lync Server 2010，畢竟這個舊版的用戶端應用程式與 Lync 2010 所支援的功能和特性並不同。但是，由於硬體或軟體衝突，您可能也想選取一群不能升級為 Lync 2010 的使用者。在該情況下，您可以建立個別的規則 (以及個別的用戶端版本原則)，允許那些使用者從 Communicator 2007 R2 登入。
Grant-CsClientVersionPolicy 指令程式讓您可以指派用戶端版本原則給個別使用者。當您建立個別使用者原則時，此原則不會自動指派給任何人；除非您呼叫 Grant-CsClientVersionPolicy 明確將原則指派給一位或一組使用者，否則指派不會生效。
請注意，用戶端版本原則不適用於同盟使用者；而是同盟使用者受到本身組織中使用的用戶端版本原則所約束。例如，假設某位同盟使用者使用用戶端 A (此為同盟組織所允許的用戶端)。只要同盟組織允許使用用戶端 A，這個使用者就可以使用該用戶端與您的組織通訊。即使您的用戶端版本原則會封鎖使用用戶端 A，此情況也成立。在您組織中強制執行的用戶端版本原則不會覆寫同盟組織中使用者的用戶端版本原則。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 Grant-CsClientVersionPolicy Cmdlet：RTCUniversalUserAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Grant-CsClientVersionPolicy"}
參數
| 參數 | 必要 | 類型 | 描述 |
|---|---|---|---|
Identity |
必要 |
User ID 參數 |
指出要將原則指派給哪一個使用者帳戶的 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:RedmondClientVersionPolicy 原則，其 PolicyName 等於 RedmondClientVersionPolicy。若要取消指派先前已指派給使用者的個別使用者原則，請將 PolicyName 設定為 Null 值 ($null)。 |
DomainController |
選用 |
字串 |
可讓您指定指派原則時連線的網域控制站。如果未包含此參數，指令程式會使用第一個可用的網域控制站。 |
PassThru |
選用 |
切換參數 |
如果存在，會使指令程式透過 Windows PowerShell 管線傳遞使用者物件 (或多個物件)。根據預設，Grant-CsClientVersionPolicy 不會透過管線傳遞任何物件。 |
WhatIf |
選用 |
切換參數 |
描述執行命令後的結果，但無須實際執行命令。 |
Confirm |
選用 |
切換參數 |
執行命令前先要求您確認。 |
輸入類型
字串值或 Microsoft.Rtc.Management.ADConnect.Schema.ADUser 物件。Grant-CsClientVersionPolicy 接受代表使用者帳戶之 Identity 的管線傳送輸入字串值。此指令程式也接受已傳送的使用者物件輸入。
傳回類型
根據預設，Grant-CsClientVersionPolicy 不會傳回物件或值。但是，如果加入 PassThru 參數，則該指令程式會傳回 Microsoft.Rtc.Management.ADConnect.Schema.OCSUserOrAppContact 物件的執行個體。
範例
-------------------------- 範例 1 --------------------------
Grant-CsClientVersionPolicy -Identity "Ken Myer" -PolicyName "RedmondClientVersionPolicy"
在範例 1 中，用戶端版本原則 RedmondClientVersionPolicy 指派給使用者 Ken Myer。
-------------------------- 範例 2 --------------------------
Get-CsUser -LdapFilter "l=Redmond" | Grant-CsClientVersionPolicy -PolicyName "RedmondClientVersionPolicy"
範例 2 所示的命令用戶端版本原則 RedmondClientVersionPolicy 會指派給所有在 Redmond 城市工作的使用者。為達成此目的，命令會先使用 Get-CsUser 搭配 LdapFilter 參數來擷取適當的使用者帳戶集合；篩選值 "l=Redmond" (其中 "l" 是小寫字母的 L，適用於 "locality" 的 LDAP 屬性名稱) 會將擷取資料的範圍限制為在 Redmond 城市工作的使用者。接著，將該集合傳送給 Grant-CsClientVersionPolicy，以將指定的原則指派給集合中的每位使用者。
-------------------------- 範例 3 --------------------------
Get-CsUser -OU "ou=Redmond,ou=North America,dc=litwareinc,dc=com" | Grant-CsClientVersionPolicy -PolicyName "RedmondClientVersionPolicy"
在範例 3 中，用戶端版本原則 RedmondClientVersionPolicy 會指派給指定組織單位 OU 中的所有使用者。為了完成這件工作，命令先呼叫 Get-CsUser 並搭配 OU 參數；其參數值表示 OU 的辨別名稱，用戶端版本原則將會指派給此 OU 的使用者 (ou=Redmond,ou=North America,dc=litwareinc,dc=com)。擷取使用者帳戶後，將集合傳送給 Grant-CsClientVersionPolicy，以將 RedmondClientVersionPolicy 指派給這些使用者。
-------------------------- 範例 4 --------------------------
Get-CsUser -Filter {VoicePolicy -eq "RedmondVoicePolicy"} | Grant-CsClientVersionPolicy -PolicyName "RedmondClientVersionPolicy"
前面的命令將用戶端版本原則 RedmondClientVersionPolicy 指派給所有先前已被指派語音原則 RedmondVoicePolicy 的使用者。為達成此目的，命令會先呼叫 Get-CsUser 搭配 Filter 參數；篩選值 {VoicePolicy -eq "RedmondVoicePolicy"} 確保只會傳回 VoicePolicy 屬性等於 "RedmondVoicePolicy" 的使用者帳戶。所得到的使用者帳戶接著便傳送給 Grant-CsClientVersionPolicy，並將用戶端版本原則 RedmondClientVersionPolicy 指派給他們。
-------------------------- 範例 5 --------------------------
Get-CsUser | Grant-CsClientVersionPolicy -PolicyName $Null
在範例 5 中，會為組織內的所有使用者取消指派先前指派給他們的任何個別使用者用戶端版本原則。為達成此目的，命令會先使用 Get-CsUser，來傳回組織中已為 Lync Server 啟用的所有使用者集合。此集合接著會傳送至 Remove-CsClientVersionPolicy，其會移除任何已指派給那些使用者的個別使用者用戶端版本原則。這可透過將 PolicyName 參數值設為 $null 來完成。