萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 伺服器教學

PowerShell 查詢已啟用 Lync/Skype for Business 用戶信息:SIP 地址、顯示名、UPN 導出實戰

前置條件

  • 安裝 Lync/Skype for Business 管理模塊(隨伺服器安裝或 RSAT)。
  • 以具備 CsAdministrator 或 CsUserAdministrator 角色的賬戶運行 PowerShell。
  • 已導入模塊:Import-Module Lync(Lync 2013)或 Import-Module SkypeForBusiness(SfB 2015/2019)。

核心 Cmdlet:Get-CsAdUser

從 AD 獲取已啟用 Lync/SfB 的用戶對象,屬性豐富,支援管道篩選與導出。

常用查詢範例

# 1. 列出所有啟用用戶的核心標識
Get-CsAdUser | Select-Object DisplayName, SipAddress, UserPrincipalName, Enabled, RegistrarPool

# 2. 導出 CSV 供 Excel 分析
Get-CsAdUser | Select-Object DisplayName, SipAddress, UserPrincipalName, Enabled, RegistrarPool, LineURI |
    Export-Csv -Path "C:\Reports\Lync_Enabled_Users_$(Get-Date -f yyyyMMdd).csv" -NoTypeInformation -Encoding UTF8

# 3. 篩選特定註冊池/OU
Get-CsAdUser -Filter {RegistrarPool -eq "pool01.contoso.com"} |
    Select-Object DisplayName, SipAddress, UserPrincipalName

# 4. 僅導出 SIP 地址清單(供批量操作)
Get-CsAdUser | Select-Object -ExpandProperty SipAddress > sip_list.txt

關鍵屬性說明

調整媒體配置:提升最大視頻分辨率

# 全局配置:允許 720p@30fps (Hd720p15M 對應 1.5Mbps 碼率上限)
Set-CsMediaConfiguration -Identity Global -EncryptionLevel SupportEncryption -MaxVideoRateAllowed Hd720p15M

# 站點級覆蓋(可選)
Set-CsMediaConfiguration -Identity "site:Beijing" -MaxVideoRateAllowed Hd1080p30M

可用分辨率枚舉:CIF250K、VGA600K、Hd720p15M、Hd1080p30M、Hd4k30M(需客戶端/硬件支持)。

批量啟用/禁用用戶範例

# 從 CSV 批量啟用(需列:UserPrincipalName)
Import-Csv users_to_enable.csv | ForEach-Object {
    Enable-CsUser -Identity $_.UserPrincipalName -RegistrarPool "pool01.contoso.com" -SipAddressType EmailAddress
}

# 批量禁用
Get-CsAdUser -OU "ou=DisabledUsers,dc=contoso,dc=com" | Disable-CsUser

常見問題排查

  • Get-CsAdUser 返回空:確認用戶已 Enable-CsUser,且 AD 複寫完成。
  • SipAddress 為空:檢查 SIP 域配置(Get-CsSipDomain)與用戶 UPN 後綴是否匹配。
  • 導出 CSV 中文亂碼:加 -Encoding UTF8(PowerShell 5.1)或 -Encoding UTF8NoBOM(PowerShell 7+)。
Get-CsAdUser 是 Lync/SfB 運維的「瑞士軍刀」,善用 Filter、Select-Object、Export-Csv 組合拳,能解決 90% 用戶信息審計、遷移、報表需求。
copyright © 萬盛學電腦網 all rights reserved
屬性含義示例
DisplayNameAD 顯示名張三
SipAddressSIP URI(登入/路由標識)sip:zhangsan@contoso.com
UserPrincipalNameUPN(AD 登入名)zhangsan@contoso.com
LineURI電話號碼(E.164 格式)tel:+86-10-12345678
RegistrarPool所屬前端池 FQDNpool01.contoso.com
Enabled是否啟用 Lync/SfBTrue/False
EnterpriseVoiceEnabled是否啟用企業語音True/False