Test-MDISensorApiConnection

Módulo:
DefenderForIdentity Module

Valida a ligação à API do Defender for Identity Sensor.

Sintaxe

UseCurrentConfiguration (Predefinição) 

Test-MDISensorApiConnection
    [<CommonParameters>]

BypassConfiguration 

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

Descrição

Esta função valida a ligação à API do Defender for Identity Sensor usando a configuração atual ou contornando-a com parâmetros personalizados.

Exemplos

EXEMPLO 1

Test-MDISensorApiConnection

Este exemplo testa a ligação à API do Defender for Identity Sensor 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 ligação à API do Defender for Identity Sensor usando parâmetros personalizados.

Parâmetros

-BypassConfiguration

Muda o parâmetro para contornar a configuração atual e usa parâmetros personalizados.

Propriedades dos parâmetros

Tipo:System.Management.Automation.SwitchParameter
Valor predefinido:False
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

BypassConfiguration
Posto:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-ProxyCredential

Especifica as credenciais a usar para o servidor proxy.

Propriedades dos parâmetros

Tipo:System.Management.Automation.PSCredential
Valor predefinido:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

BypassConfiguration
Posto:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-ProxyUrl

Especifica o URL do servidor proxy a usar para a ligação.

Propriedades dos parâmetros

Tipo:System.String
Valor predefinido:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

BypassConfiguration
Posto:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-SensorApiUrl

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

Propriedades dos parâmetros

Tipo:System.String
Valor predefinido:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

BypassConfiguration
Posto:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-SensorType

Especifica a versão do sensor instalada, ou planeada para instalar, no dispositivo. Aceita um dos seguintes valores:

  • Classic
  • Modern

Propriedades dos parâmetros

Tipo:System.String
Valor predefinido:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

BypassConfiguration
Posto:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos: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 ligação à API do Defender for Identity Sensor é bem-sucedida ou $false quando falha.