Set-CsUser
上次修改主題的時間: 2012-03-26
修改現有使用者帳戶的 Microsoft Lync Server 2010 屬性。只能對已啟用搭配使用 Lync Server 2010 的帳戶,才能修改這些屬性。
語法
Set-CsUser -Identity <UserIdParameter> [-AcpInfo <MultiValuedProperty>] [-AudioVideoDisabled <$true | $false>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Enabled <$true | $false>] [-EnterpriseVoiceEnabled <$true | $false>] [-HostedVoiceMail <Nullable>] [-LineServerURI <String>] [-LineURI <String>] [-PassThru <SwitchParameter>] [-PrivateLine <String>] [-RemoteCallControlTelephonyEnabled <$true | $false>] [-SipAddress <String>] [-WhatIf [<SwitchParameter>]]
詳細描述
Set-CsUser 可讓您修改 Active Directory 網域服務 (AD DS) 中儲存的 Lync Server 相關使用者帳戶屬性。例如,您可以停用或重新啟用使用者的 Lync Server;啟用或停用使用者的音訊/視訊 (A/V) 通訊;或者修改使用者的專用線路及線路 URI 號碼。Set-CsUser 僅適用於已啟用 Lync Server 的使用者。
只能使用 Set-CsUser 修改的屬性是與 Lync Server 相關的屬性。此指令程式無法用來修改其他使用者帳戶屬性,例如使用者的工作職稱或部門。
誰可以執行此 Cmdlet:下列群組的成員預設會獲授權可以在本機上執行 Set-CsUser Cmdlet:RTCUniversalUserAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色),請在 Windows PowerShell 提示字元中執行下列命令:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsUser\b"}
參數
參數 | 必要 | 類型 | 說明 |
---|---|---|---|
Identity |
必要 |
Xds 識別碼 |
表示要修改之使用者帳戶的 Identity。可以使用下列四種格式的其中一種來指定使用者識別:1) 使用者的 SIP 位址;2) 使用者的使用者主體名稱 (UPN);3) 使用者的網域名稱和登入名稱,格式為 domain\logon (如 litwareinc\kenmyer);4) 使用者的 Active Directory 顯示名稱 (如 Ken Myer)。也可以透過使用者的 Active Directory 辨別名稱來參考使用者識別。 使用顯示名稱作為使用者 Identity 時,您可以使用星號 (*) 萬用字元。例如,Identity "* Smith" 會傳回顯示名稱結尾為字串值 " Smith" 的所有使用者。 |
ACPInfo |
選用 |
ACPInfo 物件的陣列 |
可讓您將一個或多個第三方音訊會議提供者指派給使用者。但是,建議您使用 Set-UserAcp 指令程式來指派音訊會議提供者。 |
AudioVideoDisabled |
選用 |
布林值 |
表示是否允許使用者使用 Lync 2010 來撥打音訊/虛擬 (A/V) 電話。如果設為 True,使用者將大幅受限於傳送和接收立即訊息。 如果使用者目前已啟用遠端呼叫控制、Enterprise Voice 和/或網際網路通訊協定專用交換機 (IP-PBX) 軟體電話路由,則您無法停用 A/V 通訊。 |
Enabled |
選用 |
布林值 |
表示使用者是否已啟用 Lync Server。如果您將此值設為 False,使用者就無法再登入 Lync Server;將此值設為 True 可重新啟用使用者的登入權限。 如果使用 Enabled 參數來停用帳戶,則會保留與該帳戶相關聯的資訊 (包括指派的原則以及使用者是否已啟用 Enterprise Voice 及 (或) 遠端呼叫控制)。如果之後使用 Enabled 參數來重新啟用帳戶,將會還原相關聯的帳戶資訊。這不同於使用指令程式 Disable-CsUser 來停用使用者帳戶。當您執行 Disable-CsUser 時,將會刪除與該帳戶相關聯的所有 Lync Server 資料。 |
DomainController |
選用 |
字串 |
可讓您指定修改使用者帳戶時要連線的網域控制站。如果未加入此參數,則該指令程式將會使用第一個可用的網域控制站。 |
EnterpriseVoiceEnabled |
選用 |
布林值 |
表示使用者是否已啟用 Enterprise Voice,這是 Microsoft 的 Voice over Internet Protocol (VoIP) 實作。透過 Enterprise Voice,使用者可以使用網際網路來撥打電話,而非使用標準電話網路。 |
HostedVoiceMail |
選用 |
布林值 |
設為 True 時,可讓使用者的語音信箱通話路由傳送至託管型版本的 Microsoft Exchange Server。此外,將此選項設為 True 可讓 Lync 2010 使用者直接撥打到另一位使用者的語音信箱。 |
LineURI |
選用 |
字串 |
指派給使用者的電話號碼。指定線路統一資源識別項 (URI) 時應該採用 E.164 格式,並使用 "TEL:"首碼。例如:TEL:+14255551297。任何分機號碼都應該新增至線路 URI 的尾端,例如:TEL:+14255551297; ext=51297。 很重要的一點是,Lync Server 會將 TEL:+14255551297 和 TEL:+14255551297;ext=51297 視為兩個不同的號碼。如果您將線路 URI TEL:+14255551297 指派給 Ken Myer,然後又將線路 URI TEL:+14255551297;ext=51297 指派給 Pilar Ackerman,這樣的指派會成功,且指派給 Pilar 的號碼不會標幟為重複號碼。這是因為依據您的設定,這兩個號碼實際上是不同的。例如,在有些組織中撥 1-425-555-1297 會將您的電話轉接到 Exchange 自動語音應答。反之,僅撥分機號碼 (51297) 或使用 Microsoft Lync 2010 來撥出 1-425-555-1297 和分機號碼 51297,就會將您的電話直接轉接給使用者。 |
LineServerURI |
選用 |
字串 |
指派給使用者的遠端呼叫控制電話閘道的 URI。LineServerUri 就是閘道 URI,開頭加上 "sip:"。例如:sip:rccgateway@litwareinc.com |
PrivateLine |
選用 |
字串 |
使用者專用電話線的電話號碼。專用線路是指未發佈在 Active Directory 網域服務 (AD DS) 中的電話號碼,因此其他人無法立即得知。此外,此專用線路會略過大部分的撥入電話路由規則;例如,專用線路來電不會轉接給某人的代理人。專用線路通常用於個人電話,或應該與其他小組成員分開使用的商務電話。 指定專用線路值時應該採用 E.164 格式,並在開頭加上 "TEL:" 首碼。例如:TEL:+14255551297。 |
RemoteCallControlTelephonyEnabled |
選用 |
布林值 |
表示是否已為使用者啟用遠端呼叫控制電話。啟用遠端呼叫控制時,使用者可以採用 Lync Server 來接聽撥打到其桌面電話的來電。也可以使用 Lync 2010 來撥打電話。這些電話全部依賴標準電話網路,又稱為公用交換電話網路 (PSTN)。若要透過網際網路撥打和接聽電話,使用者必須可使用 Enterprise Voice。如需詳細資料,請參閱 EnterpriseVoiceEnabled 參數。 若要使用遠端呼叫控制,使用者必須具有 LineUri 和 LineServerUri。 |
SipAddress |
選用 |
字串 |
可讓使用者使用 SIP 裝置 (例如 Lync 2010) 來進行通訊的唯一識別碼 (類似電子郵件地址)。SIP 位址必須使用 sip:前置字元,以及有效的 SIP 網域,例如:-SipAddress sip:kenmyer@litwareinc.com。 |
PassThru |
選用 |
切換參數 |
可讓您透過管線傳遞代表要修改其帳戶之使用者的使用者物件。根據預設,Set-CsUser 指令程式不會透過管線傳遞物件。 |
WhatIf |
選用 |
切換參數 |
描述執行命令後的結果,但無須實際執行命令。 |
Confirm |
選用 |
切換參數 |
執行命令前先要求您確認。 |
輸入類型
字串或 Microsoft.Rtc.Management.ADConnect.Schema.ADUser 物件。Set-CsUser 接受管線傳送的字串值,其代表已經針對 Lync Server 啟用的使用者帳戶 Identity。該指令程式也接受管線傳送的 Active Directory 使用者物件執行個體。
傳回類型
Set-CsUser 不會傳回任何物件。
範例
-------------------------- 範例 1 --------------------------
Set-CsUser -Identity "Pilar Ackerman" -EnterpriseVoiceEnabled $True
在範例 1 中,Set-CsUser 可用來修改 Identity 為 Pilar Ackerman 的使用者帳戶。在此例子中,會修改帳戶以啟用 Enterprise Voice (Microsoft 的 VoIP 實作)。執行此工作的作法是新增 EnterpriseVoiceEnabled 參數,然後將參數值設為 $True。
-------------------------- 範例 2 --------------------------
Get-CsUser -LdapFilter "Department=Finance" | Set-CsUser -EnterpriseVoiceEnabled $True
在範例 2 中,財務部門的所有使用者都啟用帳戶來使用 Enterprise Voice。在此命令中,首先使用 Get-CsUser 指令程式和 LDAPFilter,傳回在財務部門中工作的所有使用者的集合。接著,將該資訊傳送給 Set-CsUser,由它針對集合中每一個帳戶來啟用 Enterprise Voice。