recommendationBase resource type (tipo de recurso recommendationBase)

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.
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 ao ID do Microsoft Entra 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. Tenant level indica que a recomendação afeta todo o inquilino. Outros valores possíveis incluem users, applications.
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 o estado da recomendação.
lastModifiedDateTime	DateTimeOffset	A data e hora em que o estado 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 estado 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 Tenha em atenção que tem de utilizar o cabeçalho do Prefer: include-unknown-enum-members pedido para obter os seguintes valores nesta enumeração evoluível: longLivedCredentials , , aadConnectDeprecated , adalToMsalMigration , ownerlessAppsinactiveGuests , , 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, microsoftEntraIdFree, microsoftEntraIdP1, microsoftEntraIdP2, microsoftEntraIdGovernance, microsoftEntraWorkloadId, unknownFutureValue.
status	recommendationStatus	Indica o estado 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. Por predefinição, o estado de uma recomendação está definido 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"
}