Compartilhar via

Set-AzureADUserLicense

Módulo:
AzureAD Module

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

Sintaxe

Default (Padrão) 

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 a 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, em seguida, 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 em $Licenses incluem $License do terceiro e quarto comandos.

Parâmetros

-AssignedLicenses

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

Propriedades do parâmetro

Tipo:AssignedLicenses
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:True
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-InformationAction

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

  • Continuar
  • Ignorar
  • Consulta
  • SilentlyContinue
  • Parar
  • Suspender

Propriedades do parâmetro

Tipo:ActionPreference
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:infa

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-InformationVariable

Especifica uma variável de informação.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:Iv

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-ObjectId

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

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:True
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

Observações

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