Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Namespace: 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 do 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 suas 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 | Exclua um objeto de sensor . |
| Obter chave de acesso de implantação | microsoft.graph.security.deploymentAccessKeyType | Obtenha a chave de acesso de implantação associada ao workspace do Microsoft Defender para Identidade, necessária para instalar sensores associados ao workspace. |
| Obter URI do pacote de implantação | microsoft.graph.security.sensorDeploymentPackage | Obtenha a URL e a versão do pacote de implantação do sensor. |
| Regenerar chave de acesso de implantação | microsoft.graph.security.deploymentAccessKeyType | Gere uma nova chave de acesso de implantação que pode ser usada para instalar sensores associados ao workspace. |
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 usando 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 | O status de implantação do sensor. Os valores possíveis são upToDate, outdated, updating, updateFailed, notConfigured, unreachable, disconnected, startFailure, syncing, unknownFutureValue. |
| displayName | Cadeia de caracteres | O nome de exibição do sensor. |
| domainName | Cadeia de caracteres | O nome de domínio totalmente qualificado do sensor. |
| healthStatus | microsoft.graph.security.sensorHealthStatus | O status de integridade 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. |
| migrationState | microsoft.graph.security.migrationState | O estado de migração do sensor. Os valores possíveis são: readyForMigration, notReadyForMigration, upToDate, migrationFailed, migrating, unknownFutureValue. |
| openHealthIssuesCount | Int64 | Este campo exibe a contagem de problemas de integridade relacionados a este sensor. |
| sensorType | microsoft.graph.security.sensorType | O tipo do sensor. Os valores possíveis são: adConnectIntegrated, adcsIntegrated, adfsIntegrated, domainControllerIntegrated, domainControllerStandalone, unknownFutureValue. |
| serviceStatus | microsoft.graph.security.serviceStatus | O status do serviço. Os valores possíveis são stopped, starting, running, disabled, onboarding, unknown, unknownFutureValue. |
| settings | microsoft.graph.security.sensorSettings | Informações de configurações do sensor. |
| versão | Cadeia de caracteres | A versão do sensor. |
valores deploymentStatus
| Member | Descrição |
|---|---|
| upToDate | O sensor está executando uma versão atual do sensor. |
| desatualizado | O Sensor está executando uma versão do software que está pelo menos três versões atrás da versão atual. |
| atualizando | O software do sensor está sendo atualizado. |
| updateFailed | O sensor falhou ao atualizar para uma nova versão. |
| notConfigured | O sensor requer mais configuração antes de estar totalmente operacional. Isso se aplica a sensores instalados em servidores ADFS e ADCS ou sensores autônomos. |
| inacessível | O controlador de domínio foi excluído 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. Você pode excluir esta entrada com segurança. |
| desconectado | O serviço Defender para Identidade não vê nenhuma comunicação deste sensor há 10 minutos. |
| startFailure | O sensor não efetuou pull da configuração por mais de 30 minutos. |
| Sincronização | O sensor tem atualizações de configuração pendentes, mas ainda não efetuou pull da nova configuração. |
| unknownFutureValue | Valor sentinela de enumeração evolutiva. Não usar. |
valores sensorHealthStatus
| Member | Descrição |
|---|---|
| íntegro | Nenhum problema de integridade aberto. |
| notHealthyLow | O problema de integridade aberta de maior gravidade é baixo. |
| notHealthyMedium | O problema de integridade aberto de maior gravidade é médio. |
| notHealthyHigh | O problema de integridade aberto de gravidade mais alta é alto. |
| unknownFutureValue | Valor sentinela de enumeração evolutiva. Não usar. |
valores sensorType
| Member | Descrição |
|---|---|
| adConnectIntegrated | Entra Connect sensor. |
| adcsIntegrated | Sensor de Serviços de Certificados do Active Directory (ADCS). |
| adfsIntegrated | Serviços de Federação do Active Directory) (AD FS) (ADFS). |
| domainControllerIntegrated | Sensor do controlador de domínio. |
| domainControllerStandalone | Sensor autônomo. |
| unknownFutureValue | Valor sentinela de enumeração evolutiva. Não usar. |
Relações
| Relação | Tipo | Descrição |
|---|---|---|
| healthIssues | Coleção microsoft.graph.security.healthIssue | Representa possíveis problemas na configuração do Microsoft Defender para Identidade de um cliente que o Microsoft Defender para Identidade identificou relacionados ao sensor. |
Representação JSON
A representação JSON a seguir 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)",
"migrationState": "String",
"openHealthIssuesCount": "Int64",
"sensorType": "String",
"settings": {"@odata.type": "microsoft.graph.security.sensorSettings"},
"version": "String",
"serviceStatus": "String"
}