Compartilhar via

Set-AzureADUserLicense

  • Referência
Módulo:
AzureADPreview

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 Atribuir Licença do Microsoft Graph.

Sintaxe

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 e, em seguida, armazena-o na variável $LicensedUser.

O segundo comando obtém outro usuário usando Get-AzureADUser e, em seguida, armazena-o 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 no $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.

Tipo:AssignedLicenses
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga: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
Tipo:ActionPreference
Aliases:infa
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-InformationVariable

Especifica uma variável de informações.

Tipo:String
Aliases:iv
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ObjectId

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

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False