Test-MDISensorApiConnection

Modulo:
DefenderForIdentity Module

Convalida la connessione al Defender per l'API del sensore di identità.

Sintassi

UseCurrentConfiguration (Impostazione predefinita) 

Test-MDISensorApiConnection
    [<CommonParameters>]

BypassConfiguration 

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

Descrizione

Questa funzione convalida la connessione al Defender per l'API Del sensore di identità usando la configurazione corrente o ignorandola con parametri personalizzati.

Esempio

ESEMPIO 1

Test-MDISensorApiConnection

In questo esempio viene verificata la connessione al Defender per l'API Del sensore di identità usando la configurazione corrente del sensore installato.

ESEMPIO 2

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

In questo esempio viene verificata la connessione al Defender per l'API Del sensore di identità usando parametri personalizzati.

Parametri

-BypassConfiguration

Cambiare il parametro per ignorare la configurazione corrente e usare parametri personalizzati.

Proprietà dei parametri

Tipo:System.Management.Automation.SwitchParameter
Valore predefinito:False
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

BypassConfiguration
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-ProxyCredential

Specifica le credenziali da usare per il server proxy.

Proprietà dei parametri

Tipo:System.Management.Automation.PSCredential
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

BypassConfiguration
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-ProxyUrl

Specifica l'URL del server proxy da usare per la connessione.

Proprietà dei parametri

Tipo:System.String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

BypassConfiguration
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-SensorApiUrl

Specifica l'URL del Defender per l'API del sensore di identità da testare.

Proprietà dei parametri

Tipo:System.String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

BypassConfiguration
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-SensorType

Specifica la versione del sensore installata o pianificata per l'installazione nel dispositivo. Accetta uno dei valori seguenti:

  • Classic
  • Modern

Proprietà dei parametri

Tipo:System.String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

BypassConfiguration
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

CommonParameters

Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters.

Output

System.Boolean

Il cmdlet restituisce $true quando la connessione al Defender per l'API del sensore di identità ha esito positivo o $false quando ha esito negativo.