Test-MDISensorApiConnection

Módulo:
DefenderForIdentity Module

Valida la conexión a la Defender para Identity Sensor API.

Sintaxis

UseCurrentConfiguration (valor predeterminado) 

Test-MDISensorApiConnection
    [<CommonParameters>]

BypassConfiguration 

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

Description

Esta función valida la conexión a la Defender para Identity Sensor API mediante la configuración actual o la pasa con parámetros personalizados.

Ejemplos

EJEMPLO 1

Test-MDISensorApiConnection

En este ejemplo se prueba la conexión a la Defender para Identity Sensor API mediante la configuración actual del sensor instalado.

EJEMPLO 2

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

En este ejemplo se prueba la conexión a la Defender para Identity Sensor API mediante parámetros personalizados.

Parámetros

-BypassConfiguration

Cambie el parámetro para omitir la configuración actual y usar parámetros personalizados.

Propiedades de parámetro

Tipo:System.Management.Automation.SwitchParameter
Valor predeterminado:False
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

BypassConfiguration
Posición:Named
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-ProxyCredential

Especifica las credenciales que se usarán para el servidor proxy.

Propiedades de parámetro

Tipo:System.Management.Automation.PSCredential
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

BypassConfiguration
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-ProxyUrl

Especifica la dirección URL del servidor proxy que se va a usar para la conexión.

Propiedades de parámetro

Tipo:System.String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

BypassConfiguration
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-SensorApiUrl

Especifica la dirección URL del Defender de Identity Sensor API que se va a probar.

Propiedades de parámetro

Tipo:System.String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

BypassConfiguration
Posición:Named
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-SensorType

Especifica la versión del sensor instalada o planeada para instalar en el dispositivo. Acepta uno de los siguientes valores:

  • Classic
  • Modern

Propiedades de parámetro

Tipo:System.String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

BypassConfiguration
Posición:Named
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

CommonParameters

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.

Salidas

System.Boolean

El cmdlet devuelve $true cuando la conexión a la Defender de Identity Sensor API se realiza correctamente o $false cuando se produce un error.