tipo de recurso de recomendação

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.

Representa uma melhor prática ou ação de melhoramento do Microsoft Entra ID recomendada pela Microsoft para o seu inquilino do Microsoft Entra.

O serviço de recomendação do Microsoft Entra é executado diariamente para verificar o seu inquilino relativamente às condições predefinidas para cada recomendação. Se o serviço detetar que uma recomendação se aplica ao seu inquilino, o objeto de recomendação correspondente é gerado e o respetivo estado está definido como ativo.

Para obter mais informações, consulte O que são as recomendações do Microsoft Entra?.

Herda da recommendationBase.

Métodos

Método	Tipo de retorno	Descrição
List	coleção de recomendações	Obtenha uma lista dos objetos de recomendação e respetivas propriedades.
Get	recomendação	Leia as propriedades e relações de um objeto de recomendação .
Adiar	recomendação	Marque o estado de um objeto de recomendação como postponed uma data e hora especificadas.
Dismiss	recomendação	Marcar o estado de um objeto de recomendação como dismissed.
Concluído	recomendação	Marcar o estado de um objeto de recomendação como completedByUser.
Reativar	recomendação	Marcar o estado de um objeto de recomendação como active.
Obter Pontuação de Segurança do inquilino	coleção tenantSecureScore	Obtenha dados históricos de Classificação de Segurança para o seu inquilino.

Propriedades

Propriedade	Tipo	Descrição
actionSteps	actionPass collection	Lista de ações a executar para concluir uma recomendação. Herdado da recommendationBase.
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. Herdado da recommendationBase.
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. Herdado da recommendationBase. $filterSuporta (eq).
createdDateTime	DateTimeOffset	A data e hora em que a recomendação foi detetada como aplicável ao diretório. Herdado da recommendationBase.
currentScore	Duplo	O número de pontos atingidos pelo inquilino. Aplica-se apenas a recomendações com categoria definida como identitySecureScore. Herdado da recommendationBase.
displayName	Cadeia de caracteres	O título da recomendação. Herdado da recommendationBase.
featureAreas	recommendationFeatureAreas collection	A funcionalidade de diretório à qual a recomendação está relacionada. Herdado da recommendationBase. $filterSuporta (eq).
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. Herdado da recommendationBase.
impactStartDateTime	DateTimeOffset	A data e hora futuras em que uma recomendação deve ser concluída. Herdado da recommendationBase.
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. Herdado da recommendationBase.
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. Herdado da recommendationBase.
lastCheckedDateTime	DateTimeOffset	A data e hora mais recentes em que uma recomendação foi considerada aplicável ao seu diretório. Herdado da recommendationBase.
lastModifiedBy	Cadeia de caracteres	Nome do utilizador que atualizou pela última vez o estado da recomendação. Herdado da recommendationBase.
lastModifiedDateTime	DateTimeOffset	A data e hora em que o estado de uma recomendação foi atualizado pela última vez. Herdado da recommendationBase.
maxScore	Duplo	O número máximo de pontos a atingir. Aplica-se apenas a recomendações com categoria definida como identitySecureScore. Herdado da recommendationBase.
postponeUntilDateTime	DateTimeOffset	A data e hora futuras em que o estado de uma recomendação adiada será active novamente. Herdado da recommendationBase.
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. Herdado da recommendationBase. Somente leitura. $filterSuporta (eq).
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 Herdado da recommendationBase. Atualmente, só está disponível um número limitado. Para obter mais informações, veja Tipos de recomendações. $filterSuporta (eq).
releaseType	releaseType	O tipo de versão atual da recomendação. Os valores possíveis são: preview, generallyAvailable, unknownFutureValue. Herdado da recommendationBase.
remediationImpact	Cadeia de caracteres	Descrição do impacto nos utilizadores da remediação. Aplica-se apenas a recomendações com categoria definida como identitySecureScore. Herdado da recommendationBase.
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. Herdado da recommendationBase. $filterSuporta (eq).

Relações

Relação	Tipo	Descrição
impactedResources	coleção impactedResource	A lista de objetos de diretório associados à recomendação. Herdado da recommendationBase.

Representação JSON

A representação JSON seguinte mostra o tipo de recurso.

{
  "@odata.type": "#microsoft.graph.recommendation",
  "id": "String (identifier)",
  "actionSteps": [
    {
      "@odata.type": "microsoft.graph.actionStep"
    }
  ],
  "benefits": "String",
  "category": "String",
  "createdDateTime": "String (timestamp)",
  "currentScore": "Double",
  "displayName": "String",
  "featureAreas": [
    "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"
}