Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
Namespace: microsoft.graph
Importante
As APIs na versão /beta no Microsoft Graph estão sujeitas a alterações. Não há suporte para o uso dessas APIs em aplicativos de produção. Para determinar se uma API está disponível na v1.0, use o seletor Versão.
Um tipo abstrato que expõe as propriedades do tipo de recurso de recomendação .
Métodos
Nenhum.
Propriedades
| Propriedade | Tipo | Descrição |
|---|---|---|
| actionSteps | actionPass collection | Lista de ações a executar para concluir uma recomendação. |
| benefícios | Cadeia de caracteres | Uma explicação do motivo pelo qual concluir a recomendação irá beneficiar o utilizador. Corresponde à secção Valor de uma recomendação apresentada no centro de administração do Microsoft Entra. |
| category | recommendationCategory | Indica a categoria de orientação inteligente na qual a recomendação se enquadra. Os valores possíveis são: identityBestPractice, identitySecureScore, unknownFutureValue, mdiSecureScore. Utilize o cabeçalho do Prefer: include-unknown-enum-members pedido para obter os seguintes valores desta enumeração evoluível: mdiSecureScore. |
| createdDateTime | DateTimeOffset | A data e hora em que a recomendação foi detetada como aplicável ao diretório. |
| currentScore | Duplo | O número de pontos atingidos pelo inquilino. Aplica-se apenas a recomendações com categoria definida como identitySecureScore. |
| displayName | Cadeia de caracteres | O título da recomendação. |
| featureAreas | recommendationFeatureAreas collection | A funcionalidade de diretório à qual a recomendação está relacionada. |
| id | Cadeia de caracteres | O identificador exclusivo do objeto de recomendação gerado para o seu inquilino. Esta é uma concatenação do seu ID de inquilino e uma alcunha atribuída Microsoft Entra ID para a recomendação. Por exemplo, 7918d4b5-0442-4a97-be2d-36f9f9962ece_Microsoft.Identity.IAM.Insights.ThirdPartyApps |
| impactStartDateTime | DateTimeOffset | A data e hora futuras em que uma recomendação deve ser concluída. |
| impactType | Cadeia de caracteres | Indica o âmbito do impacto de uma recomendação.
tenantLevel indica que a recomendação afeta todo o inquilino. Outros valores possíveis incluem users, apps. |
| insights | Cadeia de caracteres | Descreve o motivo pelo qual uma recomendação se aplica exclusivamente ao seu diretório. Corresponde à secção Descrição de uma recomendação apresentada no centro de administração do Microsoft Entra. |
| lastCheckedDateTime | DateTimeOffset | A data e hora mais recentes em que uma recomendação foi considerada aplicável ao seu diretório. |
| lastModifiedBy | Cadeia de caracteres | Nome do utilizador que atualizou pela última vez a status da recomendação. |
| lastModifiedDateTime | DateTimeOffset | A data e hora em que o status de uma recomendação foi atualizado pela última vez. |
| maxScore | Duplo | O número máximo de pontos a atingir. Aplica-se apenas a recomendações com categoria definida como identitySecureScore. |
| postponeUntilDateTime | DateTimeOffset | A data e hora futuras em que o status de uma recomendação adiada será active novamente. |
| prioridade | recommendationPriority | Indica a sensibilidade de tempo para a conclusão de uma recomendação . A Microsoft atribui automaticamente este valor. Os valores possíveis são: low, medium, high. |
| recommendationType | recommendationType | Nome abreviado amigável para identificar a recomendação. Os valores possíveis são: adfsAppsMigration, , enableDesktopSSO, enablePHSenableProvisioning, switchFromPerUserMFA, thirdPartyAppstenantMFA, turnOffPerUserMFA, , useAuthenticatorApp, useMyApps, staleAppCredsapplicationCredentialExpiryblockLegacyAuthenticationservicePrincipalKeyExpiryintegratedAppsstaleAppsadminMFAV2, oneAdminpasswordHashSyncselfServicePasswordResetverifyAppPublisherappRoleAssignmentsUsersuserRiskPolicyappRoleAssignmentsGroupspwagePolicyNewmfaRegistrationV2privateLinkForAADsigninRiskPolicyoverprivilegedAppsunknownFutureValueroleOverlapmanagedIdentity, longLivedCredentials, aadConnectDeprecated, adalToMsalMigration, ownerlessApps, inactiveGuests, aadGraphDeprecationApplication, , . mfaServerDeprecationaadGraphDeprecationServicePrincipal Utilize o cabeçalho do Prefer: include-unknown-enum-members pedido para obter os seguintes membros nesta enumeração evoluível: longLivedCredentials , aadConnectDeprecated , adalToMsalMigration , ownerlessApps , inactiveGuests , aadGraphDeprecationApplication , , aadGraphDeprecationServicePrincipal , mfaServerDeprecation. |
| releaseType | releaseType | O tipo de versão atual da recomendação. Os valores possíveis são: preview, generallyAvailable, unknownFutureValue. |
| remediationImpact | Cadeia de caracteres | Descrição do impacto nos utilizadores da remediação. Aplica-se apenas a recomendações com categoria definida como identitySecureScore. |
| requiredLicenses | requiredLicenses | As licenças necessárias para ver a recomendação. Os valores possíveis são: notApplicable, , microsoftEntraIdP1microsoftEntraIdFree, , microsoftEntraIdGovernancemicrosoftEntraIdP2, microsoftEntraWorkloadId, , . aatpunknownFutureValue Utilize o cabeçalho do Prefer: include-unknown-enum-members pedido para obter os seguintes valores desta enumeração evoluível: aatp. |
| status | recommendationStatus | Indica a status da recomendação com base na ação do utilizador ou do sistema. Os valores possíveis são active, completedBySystem, completedByUser, dismissed, postponed, unknownFutureValue, riskAccepted, thirdParty, planned, alternateMitigation. Utilize o cabeçalho do Prefer: include-unknown-enum-members pedido para obter os seguintes valores desta enumeração evoluível: riskAccepted , thirdParty , planned , alternateMitigation. Por predefinição, a status de uma recomendação está definida como active quando a recomendação é gerada pela primeira vez.
O estado está definido como completedBySystem quando o nosso serviço deteta que uma recomendação anteriormente ativa já não se aplica. |
Relações
| Relação | Tipo | Descrição |
|---|---|---|
| impactedResources | coleção impactedResource | A lista de objetos de diretório associados à recomendação. |
Representação JSON
A representação JSON seguinte mostra o tipo de recurso.
{
"@odata.type": "#microsoft.graph.recommendationBase",
"id": "String (identifier)",
"actionSteps": [
{
"@odata.type": "microsoft.graph.actionStep"
}
],
"benefits": "String",
"category": "String",
"createdDateTime": "String (timestamp)",
"currentScore": "Double",
"displayName": "String",
"featureAreas": [
"String"
],
"releaseType": "String",
"requiredLicenses": "String",
"impactType": "String",
"impactStartDateTime": "String (timestamp)",
"insights": "String",
"lastCheckedDateTime": "String (timestamp)",
"lastModifiedDateTime": "String (timestamp)",
"lastModifiedBy": "String",
"maxScore": "Double",
"postponeUntilDateTime": "String (timestamp)",
"priority": "String",
"status": "String",
"remediationImpact": "String",
"recommendationType": "String"
}