Skip to main content
Version: 2.3.1-preview

Test-MtAdUserHomeDirectoryCount

SYNOPSIS​

Counts users with a home directory configured in Active Directory.

SYNTAX​

Test-MtAdUserHomeDirectoryCount [-ProgressAction <ActionPreference>] [<CommonParameters>]

DESCRIPTION​

This test identifies user objects where the HomeDirectory attribute is populated. Home directories can indicate legacy file storage models, mapped drive usage, or sensitive data locations tied directly to account provisioning. Knowing how many accounts use this attribute helps assess operational dependencies and cleanup needs.

EXAMPLES​

EXAMPLE 1​

Test-MtAdUserHomeDirectoryCount

Returns $true if user data is accessible, $false otherwise. The test result includes the count of users with a home directory configured.

PARAMETERS​

-ProgressAction​

Determines how PowerShell responds to progress updates generated by a script, cmdlet, or provider, such as the progress bars generated by Write-Progress.

Type: ActionPreference
Parameter Sets: (All)
Aliases: proga

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

CommonParameters​

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

INPUTS​

OUTPUTS​

System.Boolean​

NOTES​

https://maester.dev/docs/commands/Test-MtAdUserHomeDirectoryCount