Public/Entra/Password/Get-MgPasswordPolicyDetail.ps1
|
<#
.SYNOPSIS Retrieves password policy details for all verified domains in the Microsoft Entra tenant. .DESCRIPTION This function connects to Microsoft Entra (Azure AD) using the Microsoft Graph PowerShell module and retrieves password policy details for all verified domains in the tenant. It provides information such as the password validity period and notification window for each domain. .EXAMPLE Get-MgPasswordPolicyDetail Retrieves password policy details for all verified domains in the tenant. .NOTES .CHANGELOG [1.0.0] - 2025-03-17 # Initial Version #> function Get-MgPasswordPolicyDetail { [System.Collections.Generic.List[PSCustomObject]]$pwdPolicies = @() $domains = Get-MgDomain foreach ($domain in $domains) { if ($domain.PasswordValidityPeriodInDays -eq '2147483647' -or $null -eq $domain.PasswordValidityPeriodInDays) { $pwddValidityPeriodInDays = 'Password never expire' } else { $pwddValidityPeriodInDays = $domain.PasswordValidityPeriodInDays } $object = [PSCustomObject][ordered]@{ Domain = $domain.Id PasswordValidityPeriodInDays = $pwddValidityPeriodInDays PasswordNotificationWindowInDays = $domain.PasswordNotificationWindowInDays } $pwdPolicies.Add($object) } return $pwdPolicies } |