Vérifier la connexion à Microsoft Entra (Azure AD) avec PowerShell

Points à retenir

• Le script automatise le processus de vérification de l’état de la connexion d’un appareil avec Microsoft Entra, fournissant ainsi des informations cruciales sur la sécurité et le réseau.
• Il traduit la sortie de dsregcmd.exe /status dans un format convivial, ce qui facilite l’interprétation et l’exploitation des données.
• Cet outil est particulièrement utile pour les MSP et les professionnels de l’informatique qui gèrent des réseaux diversifiés avec des ressources dans le nuage et sur site.
• Le script renforce la sécurité informatique en garantissant que les appareils sont correctement authentifiés et conformes aux normes de Microsoft Entra.
• Il surpasse les méthodes traditionnelles en termes d’efficacité et de détail, offrant une approche simplifiée pour vérifier l’état de la connexion à Azure AD.
• L’utilisation régulière du script, associée à des solutions complètes comme NinjaOne, crée un cadre solide pour la gestion et la sécurité du réseau.
• Le script est conçu pour être facile à utiliser sur Windows 10 et les versions plus récentes, mais nécessite des privilèges administratifs pour fonctionner.

Comprendre l’état de la connexion des appareils à Microsoft Entra (anciennement connu sous le nom d’Azure Active Directory ou Azure AD) est crucial dans le paysage informatique d’aujourd’hui. Pour les professionnels de l’informatique et les fournisseurs de services gérés (MSP), la possibilité de vérifier rapidement et précisément cet état est essentielle pour maintenir la sécurité et l’efficacité du réseau.

Contexte

Le script PowerShell fourni est un outil précieux pour les spécialistes de l’informatique. Il permet d’obtenir des informations détaillées sur l’état de la connexion d’un appareil à Microsoft Entra. Cette fonction est essentielle car elle permet d’identifier le type de connexion au réseau qu’un appareil a exécuté, qu’il s’agisse d’une connexion Microsoft Entra, d’une connexion à un domaine ou d’un autre type de connexion. À une époque où les services en nuage comme Azure AD jouent un rôle central dans l’infrastructure informatique des entreprises, ces outils sont indispensables pour gérer et sécuriser les appareils en réseau.

Le script :

#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 {

 

Description détaillée

Le script fonctionne de manière structurée. Dans un premier temps, il définit des paramètres pour les noms de champs personnalisés qui peuvent être utilisés pour stocker l’état de l’appareil et les informations relatives au locataire. Il définit ensuite une fonction, Get-DSRegCMD, qui convertit la sortie de dsregcmd.exe /status (un outil en ligne de commande pour vérifier l’état de l’enregistrement et de la connexion à Azure AD) en un objet PowerShell plus facile à gérer.

Ensuite, le script détermine le type de connexion de l’appareil (par exemple, Microsoft Entra Joined, Domain Joined) en fonction des informations Azure AD récupérées. Il crée ensuite un objet, $TenantInfo, contenant des informations pertinentes telles que le nom du locataire, l’identifiant du locataire, le nom de l’appareil et l’identifiant de l’appareil.

Enfin, le script rapporte ces détails et les stocke dans les champs personnalisés spécifiés, si ces champs sont fournis.

Cas d’utilisation potentiels

Imaginez un MSP qui supervise un réseau composé de ressources en nuage et sur site. À l’aide de ce script, le MSP peut rapidement vérifier l’état de la connexion de chaque appareil dans le réseau, en s’assurant que tous les appareils sont correctement intégrés à Microsoft Entra pour une sécurité et une conformité optimales.

Comparaisons

Les méthodes traditionnelles de vérification de l’état des jonctions Azure AD impliquent une vérification manuelle ou l’utilisation de scripts moins sophistiqués qui peuvent ne pas fournir des informations aussi détaillées. Ce script automatise le processus et présente les données dans un format plus convivial, ce qui permet de gagner du temps et de réduire la marge d’erreur.

FAQ

• En quoi ce script diffère-t-il de l’utilisation directe de dsregcmd.exe /status ?
  • Le script analyse et organise la sortie de dsregcmd.exe /status dans un format plus lisible et utilisable.

• Ce script peut-il être utilisé sur n’importe quel appareil Windows ?
  • Il est conçu pour Windows 10 et les versions plus récentes.

• Ai-je besoin de droits d’administrateur pour exécuter ce script ?
  • Oui, des privilèges administratifs sont généralement nécessaires pour exécuter de tels scripts qui interagissent avec les configurations du système.

Implications

L’utilisation de ce script renforce la sécurité informatique en garantissant que les appareils sont correctement connectés et authentifiés avec Microsoft Entra. Il facilite la gestion de la conformité et de la sécurité, aspects essentiels de la protection des données de l’organisation.

Recommandations

Les bonnes pratiques consistent à exécuter ce script régulièrement pour surveiller et vérifier l’état de connexion de tous les appareils, en particulier dans les environnements où l’architecture du réseau ou le déploiement des appareils changent fréquemment.

Conclusion :

L’intégration d’outils tels que NinjaOne à ce script PowerShell peut fournir des solutions complètes de gestion et de sécurité. Les capacités de NinjaOne en matière de surveillance et de gestion à distance complètent les informations obtenues à partir du script, offrant une vue plus globale de l’état des appareils et de la santé du réseau, ce qui permet aux entreprises de garder une longueur d’avance dans un paysage informatique en constante évolution.