Rationalisierung der Microsoft Entra (Azure AD)-Verbindungsüberprüfungen mit PowerShell

Die wichtigsten Erkenntnisse

• Das Skript automatisiert den Prozess der Überprüfung des Verbindungsstatus eines Geräts mit Microsoft Entra und liefert wichtige Sicherheits- und Netzwerkinformationen.
• Es übersetzt die Ausgabe von “dsregcmd.exe /status” in ein benutzerfreundliches Format, was es einfacher macht, die Daten zu interpretieren und darauf zu reagieren.
• Dieses Tool ist besonders vorteilhaft für MSPs und IT-Profis, die diverse Netzwerke mit sowohl Cloud- als auch lokal gehosteten Ressourcen verwalten müssen.
• Das Skript unterstützt die IT-Sicherheit, indem es sicherstellt, dass die Geräte ordnungsgemäß authentifiziert werden und mit den Standards von Microsoft Entra konform sind.
• Es übertrifft herkömmliche Methoden an Effizienz und Detailgenauigkeit und bietet einen optimierten Ansatz zur Überprüfung des Azure AD-Beitrittsstatus.
• Die regelmäßige Anwendung des Skripts in Verbindung mit umfassenden Lösungen wie NinjaOne schafft einen robusten Rahmen für die Netzwerkverwaltung und -sicherheit.
• Das Skript wurde für die einfache Verwendung unter Windows 10 und neueren Versionen entwickelt, erfordert aber für den Betrieb Administratorrechte.

Die Kenntnis des Verbindungsstatus von Geräten zu Microsoft Entra (früher bekannt als Azure Active Directory oder Azure AD) ist in der heutigen IT-Landschaft von entscheidender Bedeutung. Für IT-Expert:innen und Managed Service Provider (MSPs) ist die Möglichkeit, diesen Status schnell und genau zu überprüfen, der Schlüssel zur Aufrechterhaltung der Netzwerksicherheit und -effizienz.

Hintergrund

Das mitgelieferte PowerShell-Skript ist ein unschätzbares Tool für IT-Spezialisten. Sie ermöglicht den Abruf detaillierter Informationen über den Verbindungsstatus eines Geräts zu Microsoft Entra. Dies ist wichtig, weil es hilft, die Art des Netzwerk-Joins zu identifizieren, den ein Gerät ausgeführt hat, sei es Microsoft Entra Joined, Domain Joined oder andere Zustände. In einer Zeit, in der Cloud-Dienste wie Azure AD eine zentrale Rolle in der IT-Infrastruktur von Unternehmen spielen, sind solche Tools für die Verwaltung und Sicherung vernetzter Geräte unerlässlich.

Das Skript:

#Requires -Version 5.1

<#
.SYNOPSIS
    Retrieves details regarding the device's Microsoft Entra/Azure AD connection status.
.DESCRIPTION
    Retrieves details regarding the device's Microsoft Entra/Azure AD connection status.
.EXAMPLE
    (No Parameters)
    
    Join Type: Microsoft Entra Joined

    Tenant Name Tenant ID                            Device Name     Device ID                           
    ----------- ---------                            -----------     ---------                           
    NinjaOne    0e0adb39-f83f-4576-9102-db1b902ca108 KYLE-WIN11-TEST 59fd69ed-4893-41df-9f7d-211d5a0a8986

PARAMETER: -DeviceStateCustomFieldName "ReplaceMe"
    Name of a custom field to store the device state (Microsoft Entra Joined, Domain Joined etc...) in. E.g., deviceState

PARAMETER: -TenantInfoCustomFieldName "ReplaceMe"
    Name of a custom field to store tenant info in. E.g., azureInfo.

.OUTPUTS
    None
.NOTES
    Minimum Supported OS: Windows 10+
    Release Notes: Initial Release
By using this script, you indicate your acceptance of the following legal terms as well as our Terms of Use at https://www.ninjaone.com/terms-of-use.
    Ownership Rights: NinjaOne owns and will continue to own all right, title, and interest in and to the script (including the copyright). NinjaOne is giving you a limited license to use the script in accordance with these legal terms. 
    Use Limitation: You may only use the script for your legitimate personal or internal business purposes, and you may not share the script with another party. 
    Republication Prohibition: Under no circumstances are you permitted to re-publish the script in any script library or website belonging to or under the control of any other software provider. 
    Warranty Disclaimer: The script is provided “as is” and “as available”, without warranty of any kind. NinjaOne makes no promise or guarantee that the script will be free from defects or that it will meet your specific needs or expectations. 
    Assumption of Risk: Your use of the script is at your own risk. You acknowledge that there are certain inherent risks in using the script, and you understand and assume each of those risks. 
    Waiver and Release: You will not hold NinjaOne responsible for any adverse or unintended consequences resulting from your use of the script, and you waive any legal or equitable rights or remedies you may have against NinjaOne relating to your use of the script. 
    EULA: If you are a NinjaOne customer, your use of the script is subject to the End User License Agreement applicable to you (EULA).
#>

[CmdletBinding()]
param (
    [Parameter()]
    [String]$DeviceStateCustomFieldName,
    [Parameter()]
    [String]$TenantInfoCustomFieldName
)

begin {
    # Retrieve custom field name from dynamic script form
    if ($env:joinTypeCustomFieldName -and $env:joinTypeCustomFieldName -notlike "null") { $DeviceStateCustomFieldName = $env:joinTypeCustomFieldName }
    if ($env:tenantInfoCustomFieldName -and $env:tenantInfoCustomFieldName -notlike "null") { $TenantInfoCustomFieldName = $env:tenantInfoCustomFieldName }

    # Turn dsregcmd.exe /status into a much more parseable PowerShell object
    function Get-DSRegCMD {
        $DSReg = dsregcmd.exe /status | Where-Object { $_ -match " : " }

        $properties = @{}

        $DSReg | ForEach-Object {
            $split = ($_ -split '\s:\s').trim()
            $properties[$split[0]] = $split[1]
        }

        [PSCustomObject]$properties
    }
}
process {
    # Retrieve current Azure AD information
    $AzureInfo = Get-DSRegCMD

    $JoinType = if ($AzureInfo.AzureAdJoined -eq "YES" -and $AzureInfo.DomainJoined -eq "NO" -and $AzureInfo.EnterpriseJoined -eq "NO") {
        "Microsoft Entra Joined"
    }
    elseif ($AzureInfo.AzureAdJoined -eq "NO" -and $AzureInfo.DomainJoined -eq "YES" -and $AzureInfo.EnterpriseJoined -eq "NO") {
        "Domain Joined"
    }
    elseif ($AzureInfo.AzureAdJoined -eq "YES" -and $AzureInfo.DomainJoined -eq "YES" -and $AzureInfo.EnterpriseJoined -eq "NO") {
        "Microsoft Entra Hybrid Joined"
    }
    elseif ($AzureInfo.AzureAdJoined -eq "NO" -and $AzureInfo.DomainJoined -eq "YES" -and $AzureInfo.EnterpriseJoined -eq "YES") {
        "On-Premises DRS Joined"
    }
    else {
        "None"
    }

    # Retrieve the most relevant information
    $TenantInfo = [PSCustomObject]@{
        "Tenant Name" = $AzureInfo.TenantName
        "Tenant ID"   = $AzureInfo.TenantId
        "Device Name" = $AzureInfo."Device Name"
        "Device ID"   = $AzureInfo.DeviceId
    }

    # Report results into the activity log
    Write-Host "Join Type: $JoinType"
    $TenantInfo | Format-Table | Out-String | Write-Host

    # Store results into a custom field
    if($DeviceStateCustomFieldName -eq $TenantInfoCustomFieldName -and $DeviceStateCustomFieldName){
        $TenantInfo | Add-Member -MemberType NoteProperty -Name 'Join Type' -Value $JoinType

        Ninja-Property-Set -Name $DeviceStateCustomFieldName -Value ($TenantInfo | Format-List -Property "Tenant Name","Tenant ID","Join Type","Device Name","Device ID" | Out-String)
        exit 0
    }

    if ($DeviceStateCustomFieldName) {
        Ninja-Property-Set -Name $DeviceStateCustomFieldName -Value ($JoinType)
    }

    if ($TenantInfoCustomFieldName) {
        Ninja-Property-Set -Name $TenantInfoCustomFieldName -Value ($TenantInfo | Format-List | Out-String)
    }
}
end {

 

Detaillierte Aufschlüsselung

Das Skript arbeitet auf strukturierte Weise. Zunächst werden Parameter für benutzerdefinierte Feldnamen eingerichtet, die zum Speichern von Gerätestatus und Mieterinformationen verwendet werden können. Anschließend wird eine Funktion, Get-DSRegCMD, definiert, die die Ausgabe von dsregcmd.exe /status (ein Befehlszeilentool zum Überprüfen des Azure AD-Registrierungs- und Verbindungsstatus) in ein handlicheres PowerShell-Objekt umwandelt.

Als Nächstes bestimmt das Skript den Beitrittstyp des Geräts (z. B. Microsoft Entra Joined, Domain Joined) basierend auf den abgerufenen Azure AD-Informationen. Anschließend wird ein Objekt, $TenantInfo, erstellt, das einschlägige Details wie Tenant Name, Tenant ID, Device Name und Device ID enthält.

Schließlich meldet das Skript diese Details und speichert sie in den angegebenen benutzerdefinierten Feldern, sofern diese Felder vorhanden sind.

Mögliche Anwendungsfälle

Stellen Sie sich einen MSP vor, der ein Netzwerk mit einer Mischung aus Cloud- und On-Premises-Ressourcen betreut. Mit diesem Skript kann der MSP schnell den Verbindungsstatus jedes Geräts im Netzwerk ermitteln und sicherstellen, dass alle Geräte ordnungsgemäß in Microsoft Entra integriert sind, um optimale Sicherheit und Compliance zu gewährleisten.

Vergleiche

Herkömmliche Methoden zur Überprüfung des Azure AD-Beitrittsstatus beinhalten eine manuelle Überprüfung oder die Verwendung weniger ausgefeilter Skripte, die möglicherweise nicht so detaillierte Informationen liefern. Dieses Skript automatisiert den Prozess und stellt die Daten in einem benutzerfreundlicheren Format dar, was Zeit spart und die Fehlertoleranz verringert.

FAQs

• Wie unterscheidet sich dieses Skript von der direkten Verwendung von dsregcmd.exe /status?
  • Das Skript analysiert und organisiert die Ausgabe von dsregcmd.exe /status in einem besser lesbaren und nutzbaren Format.

• Kann dieses Skript auf jedem Windows-Gerät verwendet werden?
  • Es ist für Windows 10 und neuere Versionen konzipiert.

• Benötige ich Administratorrechte, um dieses Skript auszuführen?
  • Ja, für die Ausführung solcher Skripte, die mit Systemkonfigurationen interagieren, sind in der Regel Administratorrechte erforderlich.

Auswirkungen

Die Verwendung dieses Skripts erhöht die IT-Sicherheit, da es sicherstellt, dass die Geräte ordnungsgemäß mit Microsoft Entra verbunden und authentifiziert sind. Es hilft bei der Einhaltung von Vorschriften und beim Sicherheitsmanagement, den wichtigsten Aspekten beim Schutz von Unternehmensdaten.

Empfehlungen

Zu den bewährten Verfahren gehört die regelmäßige Ausführung dieses Skripts, um den Verbindungsstatus aller Geräte zu überwachen und zu überprüfen, insbesondere in Umgebungen mit häufigen Änderungen der Netzwerkarchitektur oder der Geräteverteilung.

Abschließende Überlegungen

Die Einbindung von Tools wie NinjaOne zusammen mit diesem PowerShell-Skript kann umfassende Verwaltungs- und Sicherheitslösungen bieten. Die Fähigkeiten von NinjaOne in der Fernüberwachung und -verwaltung ergänzen die Erkenntnisse aus dem Skript und bieten einen ganzheitlichen Überblick über den Gerätestatus und den Zustand des Netzwerks, so dass Unternehmen in der sich ständig weiterentwickelnden IT-Landschaft immer einen Schritt voraus sind.