tipo de recurso do sensor

Artigo
11/05/2024

Espaço de nomes: microsoft.graph.security

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 um sensor Microsoft Defender para Identidade.

Herda de entidade.

Methods

Método	Tipo de retorno	Descrição
List	coleção microsoft.graph.security.sensor	Obtenha uma lista de objetos de sensor e as respetivas propriedades.
Get	microsoft.graph.security.sensor	Leia as propriedades e relações de um objeto de sensor .
Atualizar	microsoft.graph.security.sensor	Atualize as propriedades de um objeto de sensor .
Delete	Nenhum	Eliminar um objeto de sensor .
Obter chave de acesso à implementação	microsoft.graph.security.deploymentAccessKeyType	Obtenha a chave de acesso de implementação associada à área de trabalho Microsoft Defender para Identidade, necessária para instalar sensores associados à área de trabalho.
Obter o URI do pacote de implementação	microsoft.graph.security.sensorDeploymentPackage	Obtenha o URL e a versão do pacote de implementação do sensor.
Regenerar chave de acesso à implementação	microsoft.graph.security.deploymentAccessKeyType	Gere uma nova chave de acesso de implementação que pode ser utilizada para instalar sensores associados à área de trabalho.

Propriedades

Propriedade	Tipo	Descrição
createdDateTime	DateTimeOffset	A data e hora em que o sensor foi gerado. O Carimbo de Data/Hora representa informações de data e hora com o formato ISO 8601 e está sempre em UTC. Por exemplo, meia-noite UTC em 1 de janeiro de 2014 é `2014-01-01T00:00:00Z`.
deploymentStatus	microsoft.graph.security.deploymentStatus	A implementação status do sensor. Os valores possíveis são `upToDate`, `outdated`, `updating`, `updateFailed`, `notConfigured`, `unreachable`, `disconnected`, `startFailure`, `syncing`, `unknownFutureValue`.
displayName	Cadeia de caracteres	O nome a apresentar do sensor.
domainName	Cadeia de caracteres	O nome de domínio completamente qualificado do sensor.
healthStatus	microsoft.graph.security.sensorHealthStatus	O estado de funcionamento status do sensor. Os valores possíveis são: `healthy`, `notHealthyLow`, `notHealthyMedium`, `notHealthyHigh`, `unknownFutureValue`.
id	Cadeia de caracteres	Identificador exclusivo para representar o sensor. Herdado da entidade.
openHealthIssuesCount	Int64	Este campo apresenta a contagem de problemas de estado de funcionamento relacionados com este sensor.
sensorType	microsoft.graph.security.sensorType	O tipo do sensor. Os valores possíveis são: `adConnectIntegrated`, `adcsIntegrated`, `adfsIntegrated`, `domainControllerIntegrated`, `domainControllerStandalone`, `unknownFutureValue`.
settings	microsoft.graph.security.sensorSettings	Informações sobre as definições do sensor.
versão	Cadeia de caracteres	A versão do sensor.

deploymentStatus values (valores deploymentStatus)

Member	Descrição
upToDate	O sensor está a executar uma versão atual do sensor.
desatualizado	O sensor está a executar uma versão do software que tem, pelo menos, três versões atrás da versão atual.
a atualizar	O software do sensor está a ser atualizado.
updateFailed	O sensor não conseguiu atualizar para uma nova versão.
não Configurado	O sensor requer mais configuração antes de estar totalmente operacional. Isto aplica-se aos sensores instalados em servidores ADFS e ADCS ou sensores autónomos.
inacessível	O controlador de domínio foi eliminado do Active Directory. No entanto, a instalação do sensor não foi desinstalada e removida do controlador de domínio antes de ser desativada. Pode eliminar esta entrada em segurança.
desligado	O serviço Defender para Identidade não vê nenhuma comunicação deste sensor há 10 minutos.
startFailure	O sensor não retirou a configuração durante mais de 30 minutos.
a sincronizar	O sensor tem atualizações de configuração pendentes, mas ainda não retirou a nova configuração.
unknownFutureValue	Valor da sentinela de enumeração evoluível. Não usar.

valores sensorHealthStatus

Member	Descrição
bom estado de funcionamento	Não existem problemas de estado de funcionamento abertos.
notHealthyLow	O problema de estado de funcionamento com maior gravidade aberta é baixo.
notHealthyMedium	O problema de estado de funcionamento aberto com maior gravidade é médio.
notHealthyHigh	O problema de estado de funcionamento com maior gravidade aberta é elevado.
unknownFutureValue	Valor da sentinela de enumeração evoluível. Não usar.

valores sensorType

Member	Descrição
adConnectIntegrated	Sensor Entra Connect.
adcsIntegrated	Sensor dos Serviços de Certificados do Active Directory (ADCS).
adfsIntegrated	Serviços de Federação do Active Directory (AD FS) sensor (ADFS).
domainControllerIntegrated	Sensor do controlador de domínio.
domainControllerStandalone	Sensor autónomo.
unknownFutureValue	Valor da sentinela de enumeração evoluível. Não usar.

Relações

Relação	Tipo	Descrição
healthIssues	microsoft.graph.security.healthIssue collection	Representa potenciais problemas na configuração de Microsoft Defender para Identidade de um cliente que Microsoft Defender para Identidade identificados relacionados com o sensor.

Representação JSON

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

{
  "@odata.type": "#microsoft.graph.security.sensor",
  "createdDateTime": "String (timestamp)",
  "deploymentStatus": "String",
  "displayName": "String",
  "domainName": "String",
  "healthStatus": "String",
  "id": "String (identifier)",
  "openHealthIssuesCount": "Int64",
  "sensorType": "String",
  "settings": {"@odata.type": "microsoft.graph.security.sensorSettings"},
  "version": "String"
}

Compartilhar via