Remover licenças do Microsoft 365 de contas de usuário com o PowerShell

Esse artigo se aplica ao Microsoft 365 Enterprise e ao Office 365 Enterprise.

Observação

Saiba como remover licenças de contas de usuário com o Centro de administração do Microsoft 365. Para obter uma lista de recursos adicionais, consulte Gerenciar usuários e grupos.

Usar o SDK do Microsoft Graph PowerShell

Primeiro, conecte-se ao seu locatário do Microsoft 365.

A atribuição e remoção de licenças para um usuário requer o escopo de permissão User.ReadWrite.All ou uma das outras permissões listadas na página de referência da API do Graph "Atribuir licença".

O escopo de permissão Organization.Read.All é necessário para ler as licenças disponíveis no locatário.

Connect-Graph -Scopes User.ReadWrite.All, Organization.Read.All

Para exibir as informações do plano de licenciamento em sua organização, consulte os seguintes artigos:

• Exibir licenças e serviços com o PowerShell

• Exibir a licença da conta e os detalhes do serviço com o PowerShell

Removendo licenças de contas de usuário

Para remover licenças de uma conta de usuário existente, use a seguinte sintaxe:

Set-MgUserLicense -UserId "<Account>" -RemoveLicenses @("<AccountSkuId1>") -AddLicenses @{}

Este exemplo remove o plano de licenciamento SPE_E5 (Microsoft 365 E5) do usuário BelindaN@litwareinc.com:

$e5Sku = Get-MgSubscribedSku -All | Where SkuPartNumber -eq 'SPE_E5'
Set-MgUserLicense -UserId "belindan@litwareinc.com" -RemoveLicenses @($e5Sku.SkuId) -AddLicenses @{}

Para remover todas as licenças de um grupo de usuários licenciados existentes, use a seguinte sintaxe:

$licensedUsers = Get-MgUser -Filter 'assignedLicenses/$count ne 0' `
    -ConsistencyLevel eventual -CountVariable licensedUserCount -All `
    -Select UserPrincipalName,DisplayName,AssignedLicenses

foreach($user in $licensedUsers)
{
    $licensesToRemove = $user.AssignedLicenses | Select -ExpandProperty SkuId
    $user = Set-MgUserLicense -UserId $user.UserPrincipalName -RemoveLicenses $licensesToRemove -AddLicenses @{} 
}

Para remover uma licença específica de uma lista de usuários em um CSV arquivo, execute as etapas a seguir. Este exemplo remove a licença SPE_E5 (Microsoft 365 Enterprise E5) das contas de usuário definidas no CSV arquivo C:\My Documents\Accounts.csv.

1. Crie e salve um arquivo CSV em C:\Minha Documents\Accounts.csv que contenha uma conta em cada linha sob o UserPrincipalName cabeçalho como este:

   UserPrincipalName
   akol@contoso.com
   tjohnston@contoso.com
   kakers@contoso.com
   

2. Use o seguinte comando:

   $usersList = Import-CSV -Path "C:\My Documents\Accounts.csv"
   $e5Sku = Get-MgSubscribedSku -All | Where SkuPartNumber -eq 'SPE_E5'
   foreach($user in $usersList) {
     Set-MgUserLicense -UserId $user.UserPrincipalName -RemoveLicenses @($e5Sku.SkuId) -AddLicenses @{}
   }
   

Outra maneira de liberar uma licença é excluir a conta de usuário. Para obter mais informações, consulte Excluir e restaurar contas de usuário com o PowerShell.

Confira também

Gerenciar contas de usuário, licenças e grupos do Microsoft 365 com o PowerShell

Gerenciar o Microsoft 365 com o PowerShell

Introdução ao PowerShell para o Microsoft 365