Set-AzureADUserLicense
Adiciona ou remove licenças de um serviço online da Microsoft à lista de licenças atribuídas a um utilizador.
Observação
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 à API do Microsoft Graph.
Sintaxe
Default (Predefinição)
Set-AzureADUserLicense
-ObjectId <String>
-AssignedLicenses <AssignedLicenses>
[-InformationAction <ActionPreference>]
[-InformationVariable <String>]
[<CommonParameters>]
Description
O Set-AzureADUserLicense adiciona ou remove licenças para 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, 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, em seguida, armazena-o na variável $License.
O quarto comando definiu 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 inclui $License do terceiro e quarto comandos.
Parâmetros
-AssignedLicenses
Especifica uma lista de licenças a serem atribuídas ou removidas.
Propriedades dos parâmetros
| Tipo: | AssignedLicenses |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline por nome de propriedade: | True |
| Valor dos restantes argumentos: | 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
- Pergunte
- Continuar em Silêncio
- Parar
- Suspender
Propriedades dos parâmetros
| Tipo: | ActionPreference |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
| Aliases: | Infa |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-InformationVariable
Especifica uma variável de informação.
Propriedades dos parâmetros
| Tipo: | String |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
| Aliases: | • |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-ObjectId
Especifica a ID de um usuário (como um UPN ou ObjectId) no Azure AD.
Propriedades dos parâmetros
| Tipo: | String |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline por nome de propriedade: | True |
| Valor dos restantes argumentos: | 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.
Notas
Consulte o guia de migração de Set-AzureADUserLicense para o Microsoft Graph PowerShell.