Test-MDISensorApiConnection

Modul:
DefenderForIdentity Module

Überprüft die Verbindung mit der Defender für die Identitätssensor-API.

Syntax

UseCurrentConfiguration (Standard) 

Test-MDISensorApiConnection
    [<CommonParameters>]

BypassConfiguration 

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

Beschreibung

Mit dieser Funktion wird die Verbindung mit der Defender für die Identitätssensor-API mithilfe der aktuellen Konfiguration überprüft oder mit benutzerdefinierten Parametern umgangen.

Beispiele

BEISPIEL 1

Test-MDISensorApiConnection

In diesem Beispiel wird die Verbindung mit der Defender für die Identitätssensor-API mithilfe der aktuellen Konfiguration des installierten Sensors getestet.

BEISPIEL 2

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

In diesem Beispiel wird die Verbindung mit der Defender für die Identitätssensor-API mithilfe von benutzerdefinierten Parametern getestet.

Parameter

-BypassConfiguration

Wechseln Sie zu Parametern, um die aktuelle Konfiguration zu umgehen und benutzerdefinierte Parameter zu verwenden.

Parametereigenschaften

Typ:System.Management.Automation.SwitchParameter
Standardwert:False
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

BypassConfiguration
Position:Named
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-ProxyCredential

Gibt die Anmeldeinformationen an, die für den Proxyserver verwendet werden sollen.

Parametereigenschaften

Typ:System.Management.Automation.PSCredential
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

BypassConfiguration
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-ProxyUrl

Gibt die URL des Proxyservers an, der für die Verbindung verwendet werden soll.

Parametereigenschaften

Typ:System.String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

BypassConfiguration
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-SensorApiUrl

Gibt die URL der zu testenden Defender für die Identitätssensor-API an.

Parametereigenschaften

Typ:System.String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

BypassConfiguration
Position:Named
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-SensorType

Gibt die installierte oder für die Installation geplante Sensorversion auf dem Gerät an. Akzeptiert einen der folgenden Werte:

  • Classic
  • Modern

Parametereigenschaften

Typ:System.String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

BypassConfiguration
Position:Named
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.

Ausgaben

System.Boolean

Das Cmdlet gibt zurück$true, wenn die Verbindung mit der Defender für die Identitätssensor-API erfolgreich ist oder $false wenn die Verbindung fehlschlägt.