Skip to content

DSRegTool PowerShell is a comprehensive tool that performs more than 30 different tests that help you to identify and fix the most common device registration issues for all join types.

License

Notifications You must be signed in to change notification settings

mzmaili/DSRegTool

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

80 Commits
 
 
 
 
 
 
 
 

Repository files navigation

visitor badge

Device Registration Troubleshooter Tool

Coming from the fact that it is not so easy to troubleshoot device registration issues and it does take some time, but now, using Device Registration Troubleshooter tool it is not complex anymore :)

DSRegTool PowerShell is a comprehensive tool that performs more than 50 different tests that helps you to identify and fix the most common device registration issues for all join types (Hybrid Azure AD joined, Azure AD Joined and Azure AD Register).

Script requirements

You can run DSRegTool as a normal user, except with option #3 and option #7 where you need to run DSRegTool with a user who has local admin permissions

How to run the script

Download and run the DSRegTool.ps1 script from this GitHub repo.

Why is this script useful?

DSRegTool facilitates troubleshooting device registration issues for different join types

What are tests DSRegTool perform?

1- Troubleshoot Microsoft Entra Register

  • Testing OS version
  • Testing if the device is registered to AzureAD by the signed in user
  • Testing Device Registration endpoints connectivity
  • Testing Device Registration Service
  • Testing if the device exists on AAD
  • Testing if the device is enabled on AAD

2- Troubleshoot Microsoft Entra join device

  • Testing OS version
  • Testing if the device joined to the local domain
  • Testing if the device is joined to AzureAD
  • Testing if you signed in user is a Built-in Administrator account
  • Testing if the signed in user has local admin permissions
  • Testing Device Registration endpoints connectivity
  • Testing Device Registration Service
  • Testing if the device exists on AAD.
  • Testing if the device is enabled on AAD

3- Troubleshoot Microsoft Entra hybrid join

  • Testing OS version
  • Testing if the device joined to the local domain
  • Testing if the device is joined to AzureAD
  • Testing Automatic-Device-Join task scheduler
  • Testing Domain Controller connectivity
  • Testing Service Connection Point (SCP) configuration for both client and domain sides
  • Testing Device Registration endpoints connectivity under system context:
    • Testing connectivity over winHTTP proxy (considering if domain is bypassed)
    • Testing connectivity over winInet proxy (considering if domain is bypassed)
  • Testing the following with Federated domain:
    • Testing MEX endpoint (for Federated domains)
    • Testing windowstransport endpoints (for Federated domains)
    • If federated join flow failed, checking sync join flow
    • Testing OS version if it supports fallback to sync join
    • Testing fallback to sync join configuration enablement
  • Testing the following with Managed domain / Sync join flow:
    • Testing if the device synced successfully to AAD (for Managed domains)
    • Testing userCertificate attribute under AD computer object
    • Testing self-signed certificate validity
    • Testing if the device synced to Azure AD
  • Testing Device Registration Service
  • Test if the device exists on AAD.
  • Test if the device enabled on AAD.
  • Test if the device is not pending on AAD.
  • Testing if device is stale

4- Verify Service Connection Point (SCP)

  • Testing client-side registry setting
  • Testing client-side registry configuration (tenantID, DomainName)
  • Testing Domain Controller connectivity
  • Testing Service Connection Point (SCP) on configuration partition
  • Testing Service Connection Point (SCP) configuration

5- Verify the health status of the device

  • Checks OS version
  • Checks if the device joined to the local domain
  • Checks if the device is joined to AzureAD
  • Checks if the device hybrid, Azure AD Join or Azure AD Register
  • Checks the device certificate configuration.
  • Checks if the device exists on AAD.
  • Checks if the device enabled on AAD.
  • Checks if the device is not pending on AAD
  • Shows the health status for the device
  • Provides recommendations to fix unhealthy devices

6- Verify Primary Refresh Token (PRT)

  • Checks OS version
  • Checks if the device joined to the local domain
  • Testing if the device is Hybrid Azure AD joined
  • Testing if the device is Azure AD Joined
  • Testing Azure AD PRT (DJ++ or ADDJ)
  • Testing Enterprise PRT (DJ++)
  • Testing if the device is workplace joined
  • Testing the registry configuration (WPJ)

7- Collect the logs

  • If DSRegTool is running with elevated privileges, start log collection. Otherwise, tool shows action plan to collect the logs using Feedback hub.

User experience

Alt text

Frequently asked questions

Does the script change anything?

No, It just retrieves data.

Does the script require any PowerShell module to be installed?

No, the script does not require any PowerShell module.

Will the tool fix the issue when it detects it?

No, it identifies the issue and suggest recommended steps to fix it.

What are the logs being collected by option #7?

Here is log collection output file reference:

File Name Description
dsregcmd-status.txt dsregcmd /status output
dsregcmd-debug.txt dsregcmd /debug output under system context
DeviceInfo.txt Following machine's information: OS version, Device Name, Object GUID, Distinguished Name and UserCertificate
hosts.txt Copy of machine's hosts file
ipconfig-all.txt Machine's IP address configuration
Winver.txt Windows OS version
IdentityStore.txt HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\IdentityStore registry value
WPJ-info.txt HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\AAD registry value
CloudDomainJoin.txt HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\CloudDomainJoin registry value
WorkplaceJoin-windows.txt HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Microsoft\Windows\WorkplaceJoin registry value
Winlogon-current-control-set.txt HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Winlogon registry value
WorkplaceJoin-control.txt HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\WorkplaceJoin registry value
Lsa.txt HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Lsa registry value
winHTTP.txt winHTTP configuration under system context
winInet-user.txt winInet configuration under logged on user context
winInet-user-regkey.txt winInet registry value under logged on user context
winInet-system.txt winInet configuration under system context
winInet-system-regkey.txt winInet registry value under system context
TestDeviceRegConnectivity-user.txt Result of testing Device Registration endpoints connectivity under system context
TestDeviceRegConnectivity-system.txt Result of testing Device Registration endpoints connectivity under system context
Task-Scheduler.txt Task scheduler configuration
tasklist.txt Running tasks
set.txt System environment values
services-running.txt Running services
services-config.txt sc config
SCP-config-partition.txt SCP from domain configuration partition
SCP-client-side.txt SCP client-side registry value
Schannel.txt Schannel registry value
GPResult.htm Group Policy Result
Patches.htm Installed windows updates
netstat-nao.txt Established network connections
route-print.txt Routing table
Netsetup.log Netsetup debug logs
netlogon.log Netlogon debug logs
Netlogon.txt Netlogon registry value
AAD-Operational.evtx CloudAP plugin and AAD broker plugin operational logs
AAD-Analytic.evtx CloudAP plugin and AAD broker diagnostic logs
User Device Registration-Admin.evtx Device Registration administrative logs
User Device Registration-Debug.evtx Device Registration diagnostic logs
Biometrics-Operational.evtx Biometrics operational logs
HelloForBusiness-Operational.evtx Windows Hello for Business logs
LiveId-Operational.evtx Live ID operational logs
Kerberos-Operational.evtx Kerberos operational logs
Shell-Core-Operational.evtx Shell core operational logs
WebAuthN-Operational.evtx WebAuthN operational logs including FIDO key logs
WebAuth-Operational.evtx WebAuth operational logs
WMI-Activity-Operational.evtx WMI activity operational logs
Authentication-AuthenticationPolicyFailures-DomainController.evtx Authentication Policy Failur logs
Authentication-ProtectedUser-Client.evtx Protected user failure client logs
Authentication-ProtectedUserFailures-DomainController.evtx Protected user failure authentication logs
Authentication-ProtectedUserSuccesses-DomainController.evtx Protected user successes authentication logs
CAPI2-Operational.evtx Certificate operational logs
CertPoleEng-Operational.evtx CertPoleEng operational logs
Crypto-DPAPI-Operational.evtx Crypto DPAPI operational logs
GroupPolicy-Operational.evtx Group policy operational logs
IdCtrls-Operational.evtx IdCtrls operational logs
User Control Panel-Operational.evtx Control panel operational logs
System.evtx Machine system event logs
Application.evtx Machine application event logs
LSA.etl LSA debug traces in binary format
Netmon.etl network trace
WebAuth.etl WebAuth debug traces in binary format
Kerberos.etl Kerberos debug traces in binary format
Ntlm_CredSSP.etl Ntlm_CredSSP debug traces in binary format
AADExtention\
Azure.ActiveDirectory.AADLoginForWindows
AADExtention logs
AADExtention\
AzuerVMInfo.txt
Azure VM information
AADExtention\
AzureVMTenantID.txt
Tenant ID that is associated with the Azure Subscription
AADExtention\
AzureVMAccessToken.txt
Azure VM Access Token
AADExtention\
pas.windows.net.txt
Connectivity result to pas.windows.net
AADExtention\
login.microsoftonline.com.txt
Connectivity result to login.microsoftonline.com
AADExtention\
device.login.microsoftonline.com.txt
Connectivity result to device.login.microsoftonline.com
AADExtention\
enterpriseregistration.windows.net.txt
Connectivity result to enterpriseregistration.windows.net
Log.log Shows log collection verbose logs
DSRegTool.log Copy of DSRegTool log file

About

DSRegTool PowerShell is a comprehensive tool that performs more than 30 different tests that help you to identify and fix the most common device registration issues for all join types.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published