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

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

No Microsoft 365, as licenças de planos de licenciamento (também chamados de SKUs ou planos do Microsoft 365) dão aos usuários acesso aos serviços do Microsoft 365 definidos para esses planos. No entanto, um usuário pode não ter acesso a todos os serviços disponíveis em uma licença que está atribuída atualmente a ele. Você pode usar o PowerShell para Microsoft 365 para exibir o status dos serviços em contas de usuário.

Para obter mais informações sobre planos, licenças e serviços de licenciamento, consulte Exibir licenças e serviços com o PowerShell.

Exibir detalhes da licença e do serviço da conta usando o Microsoft Graph PowerShell

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

A leitura das propriedades do usuário, incluindo detalhes da licença, requer o escopo de permissão User.Read.All ou uma das outras permissões listadas na página de referência da API do Graph "Obter um usuário".

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

Em seguida, liste os planos de licença para seu locatário com este comando.

Get-MgSubscribedSku

Use estes comandos para listar os serviços disponíveis em cada plano de licenciamento.

$allSKUs = Get-MgSubscribedSku -Property SkuPartNumber, ServicePlans 
$allSKUs | ForEach-Object {
    Write-Host "Service Plan:" $_.SkuPartNumber
    $_.ServicePlans | ForEach-Object {$_}
}

Use estes comandos para listar as licenças atribuídas a uma conta de usuário.

Get-MgUserLicenseDetail -UserId "<user sign-in name (UPN)>"

Por exemplo:

Get-MgUserLicenseDetail -UserId "belindan@litwareinc.com"

Para exibir serviços para uma conta de usuário

Para exibir todos os serviços do Microsoft 365 aos quais um usuário tem acesso, use a seguinte sintaxe:

(Get-MgUserLicenseDetail -UserId <user account UPN> -Property ServicePlans)[<LicenseIndexNumber>].ServicePlans

Este exemplo mostra os serviços aos quais o usuário BelindaN@litwareinc.com tem acesso. Isso mostra os serviços associados a todas as licenças atribuídas à conta dela.

(Get-MgUserLicenseDetail -UserId belindan@litwareinc.com -Property ServicePlans).ServicePlans

Este exemplo mostra os serviços aos quais o usuário BelindaN@litwareinc.com tem acesso a partir da primeira licença atribuída à sua conta (o número de índice é 0).

(Get-MgUserLicenseDetail -UserId belindan@litwareinc.com -Property ServicePlans)[0].ServicePlans

Para exibir todos os serviços para um usuário que recebeu várias licenças, use a seguinte sintaxe:

$userUPN="<user account UPN>"
$allLicenses = Get-MgUserLicenseDetail -UserId $userUPN -Property SkuPartNumber, ServicePlans
$allLicenses | ForEach-Object {
    Write-Host "License:" $_.SkuPartNumber
    $_.ServicePlans | ForEach-Object {$_}
}

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