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 a um utilizador.

Nota

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

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 utilizador.

Exemplos

Exemplo 1: adicionar uma licença a um utilizador com base num utilizador 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 utilizador com o cmdlet Get-AzureADUser (./Get-AzureADUser.md) e, em seguida, armazena-o na variável $LicensedUser.

O segundo comando obtém outro utilizador com Get-AzureADUser e, em seguida, armazena-o na variável $User.

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

O quarto comando definiu a propriedade SkuId de $License para o mesmo valor que a propriedade SkuId de $LicensedUser.

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

O sexto comando adiciona a licença no $License ao $Licenses.

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

Parâmetros

-AssignedLicenses

Especifica uma lista de licenças a atribuir ou remover.

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

-InformationAction

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

  • Continuar
  • Ignorar
  • Inquire
  • SilentlyContinue
  • Parar
  • Suspender
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ção.

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

-ObjectId

Especifica o ID de um utilizador (como um UPN ou ObjectId) no Azure AD.

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

Notas

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