Set-AzureADUserLicense

  • Referência
Módulo:
AzureAD

Adiciona ou remove licenças de um serviço online da Microsoft à lista de licenças atribuídas para um usuário.

Observação

O cmdlet Set-AzureADUserLicense foi preterido. Saiba como atribuir licenças com o Microsoft Graph PowerShell. Para obter mais informações, consulte a API do Graph Atribuir Licença microsoft.

Syntax

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

Description

O Set-AzureADUserLicense adiciona ou remove licenças de um serviço online da Microsoft à lista de licenças atribuídas para um usuário.

Exemplos

Exemplo 1: Adicionar uma licença a um usuário com base em um usuário de modelo

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

O primeiro comando obtém um usuário usando o cmdlet Get-AzureADUser (./Get-AzureADUser.md)e o armazena na variável $LicensedUser.

O segundo comando obtém outro usuário usando Get-AzureADUser e o armazena na variável $User.

O terceiro comando cria um tipo AssignedLicense e o armazena na variável $License.

O quarto comando define a propriedade SkuId de $License com o mesmo valor que a propriedade SkuId de $LicensedUser.

O quinto comando cria um objeto AssignedLicenses e o armazena na variável $Licenses.

O sexto comando adiciona a licença em $License a $Licenses.

O comando final atribui as licenças em $Licenses ao usuário em $User. As licenças no $Licenses incluem $License do terceiro e quarto comandos.

Parâmetros

-AssignedLicenses

Especifica uma lista de licenças a serem atribuídas ou removidas.

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

-InformationAction

Especifica como esse cmdlet responde a um evento de informações. Os valores aceitáveis para esse parâmetro são:

  • Continuar
  • Ignorar
  • Consultar
  • SilentlyContinue
  • Stop
  • Suspend
Type:ActionPreference
Aliases:infa
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InformationVariable

Especifica uma variável de informações.

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

-ObjectId

Especifica a ID de um usuário (como UPN ou ObjectId) no Azure AD.

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

Observações

Consulte o guia de migração de Set-AzureADUserLicense para o Microsoft Graph PowerShell.