使用PowerShell 批量修改O365 用户UPN

Posted

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了使用PowerShell 批量修改O365 用户UPN相关的知识,希望对你有一定的参考价值。

    又来分享一些日常用的小脚本哈,比如说有些小型企业在使用O365时开始用的是O365自带的域名,过了一段时间后想用自己的域名了,这时候管理员就需要将用户的UPN修改成自定义域名。总体来说这不是个复杂的活,简单写的话可能几行代码就搞定了,当然如果想写的稍微规范些,那么可以再加上一些逻辑控制类的语句


param (
	[parameter(Mandatory = $true)]
	[string]$CustomDomainName,
	[parameter(Mandatory = $false)]
	[bool]$IncludeGlobalAdmin=$false
)

function Change-UserPrincipalName
{
	param (
		[parameter(Mandatory = $true)]
		[string]$OldUserPrincipalName,
		[parameter(Mandatory = $true)]
		[string]$CustomDomainName
	)
	
	$Error.clear()
	
	try
	{
		$Role = Get-MsolUserRole -UserPrincipalName $OldUserPrincipalName 
		$Change = $true
		if ($Role -ne $null)
		{
			#Company Administrator
			if ($Role.ObjectId -eq "62e90394-69f5-4237-9190-012177145e10")
			{
				if ($IncludeGlobalAdmin -eq $false)
				{
					Write-Host ("$(Get-Date) * Found {0} {1}, pass" -f $Role.Name, $OldUserPrincipalName) -ForegroundColor 'yellow'
					$Change = $false
				}
				
			}
			#Directory Synchronization Account
			elseif ($Role.ObjectId -eq "d29b2b05-8046-44ba-8758-1e26182fcf32")
			{
				Write-Host ("$(Get-Date) * Found {0} {1}, pass" -f $Role.Name, $OldUserPrincipalName) -ForegroundColor 'yellow'
				$Change = $false
			}
		}
		
		if ($Change -eq $true)
		{
			$UserName = $OldUserPrincipalName.Split("@")[0]
			$NewUserPrincipalName = $UserName + "@" + $CustomDomainName
			Write-Host ("$(Get-Date) * Changing user principal name {0} to {1}" -f $OldUserPrincipalName, $NewUserPrincipalName) -ForegroundColor 'Cyan'
			Set-MsolUserPrincipalName -UserPrincipalName $OldUserPrincipalName -NewUserPrincipalName $NewUserPrincipalName
		}
	}
	catch
	{
		Write-Warning $Error[0].Exception.Message
	}
	
	
	
}
$Domains = Get-MsolDomain
if ($Domains.Name.Tolower().contains($CustomDomainName.ToLower()))
{
	Get-MsolUser -All | %{
		
		Change-UserPrincipalName -OldUserPrincipalName $_.UserPrincipalName -CustomDomainName $CustomDomainName
	}
}
else
{
	throw "$(Get-Date) * Domain Name $CustomDomainName not found in your tenant"
}



对于Global Admin,脚本里加了一个bool类型的参数来决定是否要修改Global admin的UPN,这样对于管理员来说做这种操作的时候可以更可控一些


以上是关于使用PowerShell 批量修改O365 用户UPN的主要内容,如果未能解决你的问题,请参考以下文章

O365订阅用户License管理

使用PowerShell deprovision O365 资源

O365 PowerShell Script安全与合规中心审核日志

office 365通过PowerShell批量添加共享邮箱成员

Powershell批量修改用户的UPN后缀

O365 PowerShell Script邮箱及OneDrive使用报告