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

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

Descrição

Este runbook verifica a disponibilidade de licenças com base nas SKUs transmitidas 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 cai 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, exporta-as para arquivos CSV e os envia por e-mail.

Personalização do Runbook

Configuração relacionada ao envio de e-mails

Este runbook envia e-mails usando a Microsoft Graph API. 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 detalhes no Configurar 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 de exibição

• 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 (evitar faltas):

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

Apenas limite máximo (evitar excesso de provisionamento):

[
    {
        "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
                }
            }
        }
    }
}

Encontrando Números de Peça 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 trabalho

• Exportação CSV (License_Threshold_Violations.csv)

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

Quando todos dentro dos limites:

• Nenhum e-mail enviado

• Trabalho concluído 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

Organization → General → Report License Assignment_Scheduled

Permissões

Permissões de aplicativo

• 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:

• SKUPartNumber: O identificador de SKU da Microsoft

• FriendlyName: Nome de exibição para a licença

• MinThreshold: (Opcional) Número mínimo de licenças que devem estar disponíveis

• MaxThreshold: (Opcional) 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

EmailTo

Pode ser um único endereço ou vários endereços separados por vírgula (string). A função envia e-mails individuais para cada destinatário por motivos de privacidade.

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

EmailFrom

O endereço de e-mail do remetente. Isso precisa ser configurado na personalização do runbook

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

Voltar à visão geral de Referência do Runbook