基于部门将用户添加至Office 365共享邮箱的PowerShell问题排查

嘿，我帮你排查下这段PowerShell代码的问题，主要是循环逻辑和参数传递出了问题，手动执行能成但脚本不行，确实是变量和循环的锅！

核心问题点 #

• 循环嵌套冗余+变量引用错误：你写了ForEach ($UserPrincipalName in $DL)之后，又用$DL | % {...}，等于把整个用户集合重复遍历了一遍，而且没正确引用当前循环的用户对象。
• 用户身份传递错误：Get-MsolUser | select UserPrincipalName返回的是带UserPrincipalName属性的对象，不是纯字符串，直接用$_传递给-User参数会导致识别失败。
• 命令语法错误：-User $_被写在了ForEach-Object（%）的括号外面，属于参数位置错误，PowerShell没法识别。
• 隐藏的符号问题：原代码里New-PSSession的参数用了中文连字符–，这会直接导致PowerShell无法识别命令参数。

修正后的代码 #

$UserCredential = Get-Credential
# 修正中文连字符为英文，确保命令可识别
$Session = New-PSSession -ConfigurationName Microsoft.Exchange -ConnectionURI https://outlook.office365.com/powershell-liveid/ -Credential $UserCredential -Authentication Basic -AllowRedirection
# 仅修改当前用户的执行策略，避免影响系统全局设置
Set-ExecutionPolicy Unrestricted -Scope CurrentUser -Force
# 导入会话时添加-AllowClobber，避免命令冲突
Import-PSSession $Session -AllowClobber
Import-Module msonline
Connect-MsolService -Credential $UserCredential

# 直接提取UserPrincipalName字符串集合，简化后续处理
$DL = Get-MsolUser -All -Department "Staff" | Select-Object -ExpandProperty UserPrincipalName

# 遍历每个用户，添加共享邮箱权限
ForEach ($userUPN in $DL) {
    Add-MailboxPermission -Identity "shared-mailbox@domain.com" -User $userUPN -AccessRights FullAccess -InheritanceType All
}

Remove-PSSession $Session

关键修改说明 #

1. 符号修正：把所有中文连字符换成英文-，这是很多新手容易踩的坑，PowerShell对符号的中英文非常敏感。
2. 简化用户标识提取：用-ExpandProperty UserPrincipalName直接把用户的UPN提取成纯字符串数组，不用再处理对象属性，避免后续引用错误。
3. 精简循环逻辑：直接遍历字符串数组，每个循环迭代对应一个用户的UPN，参数传递更直观。
4. 优化权限与会话导入：添加-Scope CurrentUser和-Force避免执行策略修改时的权限提示，-AllowClobber防止导入Exchange会话时和本地命令冲突。

如果运行还是有问题，可以先检查你的账号是否拥有Exchange管理员权限，或者确认共享邮箱的地址是否完全正确哦！

内容的提问来源于stack exchange，提问作者Josh