Disable-CsUser
上次修改主題的時間： 2012-03-23
修改所指定使用者的 Active Directory 帳戶；此修改會讓使用者無法使用 Microsoft Lync 2010 之類的 Microsoft Lync Server 2010 用戶端。Disable-CsUser 只限制與 Lync Server 2010 相關的活動；不會停用或移除使用者的 Active Directory 帳戶。
語法
Disable-CsUser -Identity <UserIdParameter> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-PassThru <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
詳細描述
Disable-CsUser 指令程式會從 Active Directory 使用者帳戶中刪除與 Lync Server 相關的所有屬性資訊；這樣會讓使用者無法登入 Lync Server。當您執行 Disable-CsUser 時，所有與 Lync Server 相關的屬性都會自帳戶移除，包括任何已指派給該帳戶之個別使用者原則的 Identity。之後，您可以使用 Enable-CsUser 指令程式來重新啟用帳戶。但是，您將必須重新建立所有先前與該帳戶建立關聯的 Lync Server 相關資訊 (例如原則指派)。如果您要讓使用者無法登入 Lync Server，但不想失去這些帳戶的所有資訊，可改用 Set-CsUser。如需詳細資料，請參閱 Set-CsUser 說明主題。
以 Disable-CsUser 停用帳戶之後，Get-CsUser 指令程式不會再傳回受影響的使用者；這是因為使用者已無有效的 Lync Server 帳戶。若要擷取已停用使用者帳戶的資訊，請使用 Get-CsAdUser。
此外，屬於刪除的使用者帳戶的使用者資料也會從後端資料庫移除；例如，使用者會被從組織的連絡人清單移除，該使用者排程的任何會議也會被一併刪除。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 Disable-CsUser Cmdlet：RTCUniversalUserAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Disable-CsUser"}
參數
| 參數 | 必要 | 類型 | 描述 |
|---|---|---|---|
Identity |
必要 |
UserIdParameter |
表示要停用之使用者帳戶的 Identity。可以使用下列四種格式的其中一種來指定使用者識別：1) 使用者的 SIP 位址；2) 使用者的使用者主體名稱 (UPN)；3) 使用者的網域名稱和登入名稱，格式為 domain\logon (如 litwareinc\kenmyer)；4) 使用者的 Active Directory 顯示名稱 (如 Ken Myer)。您也可以使用 Active Directory 辨別名稱來參照使用者帳戶。 使用「顯示名稱」作為使用者 Identity 時，您可以使用星號 (*) 萬用字元。例如，若 Identity 為 "* Smith"，則會傳回所有顯示名稱結尾為字串值 " Smith" 的使用者。 |
DomainController |
選用 |
字串 |
可讓您連線至指定的網域控制站，以停用使用者帳戶。若要連線至特定的網域控制站，請加入 DomainController 參數，後面加上電腦名稱 (例如，atl-cs-001) 或其完整網域名稱 (FQDN) (例如，atl-cs-001.litwareinc.com)。 |
PassThru |
選用 |
切換參數 |
可讓您經由管線傳遞代表所要停用使用者帳戶的使用者物件。根據預設，Disable-CsUser 指令程式不會沿管線傳遞任何物件。 |
Confirm |
選用 |
切換參數 |
執行命令前先要求您確認。 |
WhatIf |
選用 |
切換參數 |
描述執行命令後的結果，但無須實際執行命令。 |
輸入類型
字串或 Microsoft.Rtc.Management.ADConnect.Schema.ADUser 物件。Disable-CsUser 會接受代表使用者帳戶 (已為 Lync Server 啟用) 識別的管線字串值。指令程式也會接受 Active Directory 使用者物件的管線執行個體。
傳回類型
Disable-CsUser 不會傳回值或物件。而是指令程式會設定 Microsoft.Rtc.Management.ADConnect.Schema.ADUser 物件的執行個體。
範例
-------------------------- 範例 1 --------------------------
Disable-CsUser -Identity "Ken Myer"
上述範例會停用使用者 Ken Myer 的 Lync Server 帳戶。在此範例中，使用者的顯示名稱可用來表示其 Identity。
-------------------------- 範例 2 --------------------------
Get-CsUser -LDAPFilter "Department=Finance" | Disable-CsUser
在範例 2 中，財務部門的所有使用者都已停用其 Lync Server 帳戶。為了執行此作業，命令會先使用 Get-CsUser 指令程式搭配 LDAPFilter 參數，傳回屬於財務部門的所有使用者的集合。接著，將該集合傳送給 Disable-CsUser，以停用集合中的每一個帳戶。
-------------------------- 範例 3 --------------------------
Get-CsUser -UnassignedUser | Disable-CsUser
在前一個範例中，目前未指派至登錄器集區的所有使用者帳戶都會停用。為達成此目的，會呼叫 Get-CsUser 搭配 UnassignedUser 參數。此參數將傳回的資料限制於具備有效使用者帳戶，但未指派至登錄器集區的使用者。接著，將該集合傳送給 Disable-CsUser，以停用集合中的每一個帳戶。