Test-MDISensorApiConnection

Módulo:
DefenderForIdentity Module

Valida a conexão com o Defender para a API do Sensor de Identidade.

Sintaxe

UseCurrentConfiguration (Default) 

Test-MDISensorApiConnection
    [<CommonParameters>]

BypassConfiguration 

Test-MDISensorApiConnection
    -SensorApiUrl <String>
    -SensorType <Classic|Modern>
    [-BypassConfiguration]
    [-ProxyUrl <String>]
    [-ProxyCredential <PSCredential>]
    [<CommonParameters>]

Description

Essa função valida a conexão com o Defender para a API do Sensor de Identidade usando a configuração atual ou ignorando-a com parâmetros personalizados.

Exemplos

EXEMPLO 1

Test-MDISensorApiConnection

Este exemplo testa a conexão com o Defender para a API do Sensor de Identidade usando a configuração atual do sensor instalado.

EXEMPLO 2

$connectionParams = @{
    BypassConfiguration = $true
    SensorApiUrl        = 'https://contososensorapi.atp.azure.com'
    SensorType          = 'Classic'
    ProxyUrl            = 'https://myproxy.contoso.com:8080'
    ProxyCredential     = $credential
}
Test-MDISensorApiConnection @connectionParams

Este exemplo testa a conexão com o Defender para a API do Sensor de Identidade usando parâmetros personalizados.

Parâmetros

-BypassConfiguration

Alterne o parâmetro para ignorar a configuração atual e usar parâmetros personalizados.

Propriedades do parâmetro

Tipo:System.Management.Automation.SwitchParameter
Valor padrão:False
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

BypassConfiguration
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-ProxyCredential

Especifica as credenciais a serem usadas para o servidor proxy.

Propriedades do parâmetro

Tipo:System.Management.Automation.PSCredential
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

BypassConfiguration
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-ProxyUrl

Especifica a URL do servidor proxy a ser usada para a conexão.

Propriedades do parâmetro

Tipo:System.String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

BypassConfiguration
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-SensorApiUrl

Especifica a URL do Defender para teste da API do Sensor de Identidade.

Propriedades do parâmetro

Tipo:System.String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

BypassConfiguration
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-SensorType

Especifica a versão do sensor instalada ou planejada para instalação no dispositivo. Aceita um dos seguintes valores:

  • Classic
  • Modern

Propriedades do parâmetro

Tipo:System.String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

BypassConfiguration
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

Saídas

System.Boolean

O cmdlet retorna $true quando a conexão com o Defender para a API do Sensor de Identidade é bem-sucedida ou $false quando falha.