Relatório de Atribuição de Licença Agendado

Gerar e enviar por email um relatório de disponibilidade de licenças com base em limiares

Descrição

Este runbook verifica a disponibilidade de licenças com base nos SKUs transmitidos e envia um relatório por e-mail se quaisquer limites forem atingidos. Dois tipos de limites podem ser configurados. O primeiro tipo é um limite mínimo, que aciona um alerta quando o número de licenças disponíveis fica abaixo de um número especificado. O segundo tipo é um limite máximo, que aciona um alerta quando o número de licenças disponíveis excede um número especificado. O relatório inclui informações detalhadas sobre licenças que estão fora dos limites configurados, as exporta para arquivos CSV e as envia por e-mail.

Personalização do Runbook

Configuração referente ao envio de e-mails

Este runbook envia e-mails usando a API Microsoft Graph. Para enviar e-mails via Graph API, você precisa configurar um endereço de e-mail existente na personalização do runbook.

Este processo é descrito em detalhe em Configuração de Relatórios por E-mail documentação.

Configuração InputJson

Cada configuração de licença requer:

• SKUPartNumber (obrigatório): identificador de SKU da Microsoft

• FriendlyName (obrigatório): nome exibido

• MinThreshold (opcional): Alerta quando licenças disponíveis < limite

• MaxThreshold (opcional): Alerta quando licenças disponíveis > limite

Pelo menos um limite deve ser definido por licença.

Exemplos de Configuração

Apenas limite mínimo (prevenir faltas):

[
    {
        "SKUPartNumber": "ENTERPRISEPACK",
        "FriendlyName": "Microsoft 365 E3",
        "MinThreshold": 50
    }
]

Apenas limite máximo (prevenir superprovisionamento):

[
    {
        "SKUPartNumber": "POWER_BI_PRO",
        "FriendlyName": "Power BI Pro",
        "MaxThreshold": 500
    }
]

Ambos os limites (manter faixa):

[
    {
        "SKUPartNumber": "ENTERPRISEPREMIUM",
        "FriendlyName": "Microsoft 365 E5",
        "MinThreshold": 50,
        "MaxThreshold": 150
    }
]

Personalização Completa do Runbook

{
    "Settings": {
        "RJReport": {
            "EmailSender": "[email protected]"
        }
    },
    "Runbooks": {
        "rjgit-org_general_report-license-assignment_scheduled": {
            "Parameters": {
                "EmailTo": {
                    "DisplayName": "Endereço(s) de E-mail do Destinatário"
                },
                "InputJson": {
                    "Hide": true,
                    "DefaultValue": [
                        {
                            "SKUPartNumber": "SPE_E5",
                            "FriendlyName": "Microsoft 365 E5",
                            "MinThreshold": 20,
                            "MaxThreshold": 30
                        },
                        {
                            "SKUPartNumber": "FLOW_FREE",
                            "FriendlyName": "Microsoft Power Automate Free",
                            "MinThreshold": 10
                        }
                    ]
                },
                "EmailFrom": {
                    "Hide": true
                },
                "CallerName": {
                    "Hide": true
                }
            }
        }
    }
}

Localizando Números de Parte do SKU

Connect-MgGraph -Scopes "Organization.Read.All"
Get-MgSubscribedSku | Select-Object SkuPartNumber, SkuId | Sort-Object SkuPartNumber

SKUs comuns:

• ENTERPRISEPACK - Microsoft 365 E3

• ENTERPRISEPREMIUM - Microsoft 365 E5

• EMS - Enterprise Mobility + Security E3

Saída

Quando violações detectadas:

• Saída no console no log do job

• Exportação CSV (License_Threshold_Violations.csv)

• Relatório por e-mail com resumo, violações, recomendações e anexo CSV

Quando tudo dentro dos limites:

• Nenhum e-mail enviado

• Job conclui com sucesso

Solução de Problemas

SKU Não Encontrado: Verifique se o SKU existe usando Get-MgSubscribedSku

E-mail Não Enviado: Verifique a configuração EmailFrom e a permissão Mail.Send

JSON Inválido: Valide o formato JSON antes da configuração

Nota de Migração

Legado WarningThreshold mapeia automaticamente para MinThreshold - configurações antigas continuam a funcionar.

Localização

Organização → Geral → Relatório de Atribuição de Licença (Agendado)

Nome completo do Runbook

rjgit-org_general_report-license-assignment_scheduled

Permissões

Permissões da aplicação

• Tipo: Microsoft Graph

  • Organization.Read.All

  • User.Read.All

  • Mail.Send

Parâmetros

InputJson

Array JSON contendo configurações de SKU com limites. Cada entrada deve incluir um SKUPartNumber para o identificador de SKU da Microsoft, um FriendlyName como o nome exibido da licença, um MinThreshold opcional especificando o número mínimo de licenças que devem estar disponíveis, e um MaxThreshold opcional especificando o número máximo de licenças que devem estar disponíveis.

Isto precisa ser configurado na personalização do runbook

Propriedade	Valor
Obrigatório	true
Valor Padrão
Tipo	Objeto

EmailPara

Endereço de e-mail do destinatário ou lista de destinatários separada por vírgulas.

Propriedade	Valor
Obrigatório	true
Valor Padrão
Tipo	String

EmailDe

Endereço de e-mail do remetente resolvido a partir das configurações.

Propriedade	Valor
Obrigatório	false
Valor Padrão
Tipo	String

Voltar ao resumo de Referência do Runbook