你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

Set-AzureADUserLicense

在用户分配的许可证列表中添加或删除 Microsoft 联机服务的许可证。

注意

Set-AzureADUserLicense cmdlet 已弃用。 了解如何使用 Microsoft Graph PowerShell 分配许可证。 有关详细信息,请参阅分配许可证 Microsoft 图形 API。

语法

Set-AzureADUserLicense
   -ObjectId <String>
   -AssignedLicenses <AssignedLicenses>
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]

说明

Set-AzureADUserLicense 向用户分配的许可证列表中添加或删除 Microsoft 联机服务的许可证。

示例

示例 1:基于模板用户向用户添加许可证

PS C:\> $LicensedUser = Get-AzureADUser -ObjectId "TemplateUser@contoso.com"  
PS C:\> $User = Get-AzureADUser -ObjectId "User@contoso.com"  
PS C:\> $License = New-Object -TypeName Microsoft.Open.AzureAD.Model.AssignedLicense 
PS C:\> $License.SkuId = $LicensedUser.AssignedLicenses.SkuId 
PS C:\> $Licenses = New-Object -TypeName Microsoft.Open.AzureAD.Model.AssignedLicenses 
PS C:\> $Licenses.AddLicenses = $License 
PS C:\> Set-AzureADUserLicense -ObjectId $User.ObjectId -AssignedLicenses $Licenses

第一个命令使用 Get-AzureADUser (./Get-AzureADUser.md) cmdlet 获取用户,然后将其存储在 $LicensedUser 变量中。

第二个命令使用 Get-AzureADUser 获取其他用户,然后将其存储在 $User 变量中。

第三个命令创建 AssignedLicense 类型,然后将其存储在 $License 变量中。

第四个命令将 $License 的 SkuId 属性设置为与 $LicensedUser 的 SkuId 属性相同的值。

第五个命令创建一个 AssignedLicenses 对象,并将其存储在 $Licenses 变量中。

第六个命令将 $License 中的许可证添加到 $Licenses。

最后一个命令将 $Licenses 中的许可证分配给 $User 中的用户。 $Licenses 中的许可证包括第三个和第四个命令的$License。

参数

-AssignedLicenses

指定要分配或删除的许可证的列表。

Type:AssignedLicenses
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-InformationAction

指定此 cmdlet 如何响应信息事件。 此参数的可接受值为:

  • 继续
  • 忽略
  • 查询
  • SilentlyContinue
  • 停止
  • 挂起
Type:ActionPreference
Aliases:infa
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InformationVariable

指定信息变量。

Type:String
Aliases:iv
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ObjectId

将用户 ID 指定为 Azure AD 中的 UPN 或 ObjectId) (。

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

备注

请参阅 Microsoft Graph PowerShell 的 Set-AzureADUserLicense 迁移指南