Public/MSOL/Get-365MsolUser.ps1
|
function Get-365MsolUser { <# .SYNOPSIS Export Office 365 MsolUsers .DESCRIPTION Export Office 365 MsolUsers .PARAMETER DomainFilter Specifies the domain to filter results on. This must be a verified domain for the company. All users with an email address, primary or secondary, on this domain is returned. .PARAMETER DetailedReport Provides a full report of all attributes. Otherwise, only a refined report will be given. .EXAMPLE Get-365MsolUser | Export-Csv c:\scripts\All365MsolUsers.csv -notypeinformation -encoding UTF8 .EXAMPLE Get-365MsolUser -DetailedReport | Export-Csv c:\scripts\All365MsolUsers.csv -notypeinformation -encoding UTF8 .EXAMPLE 'contoso.com','fabrikam.com' | Get-365MsolUser -DetailedReport| Export-Csv c:\scripts\365MsolUsers.csv -notypeinformation -encoding UTF8 .EXAMPLE foreach ($UPN in $UPNList) { Get-365MsolUser -UserPrincipalName $UPN -DetailedReport | Export-Csv c:\scripts\365MsolUsers.csv -notypeinformation -encoding UTF8 } .EXAMPLE 'contoso.com','fabrikam.com' | Get-365MsolUser | Export-Csv c:\scripts\365MsolUsers.csv -notypeinformation -encoding UTF8 #> [CmdletBinding()] param ( [Parameter()] [switch] $DetailedReport, [Parameter()] $UserPrincipalName, [Parameter(ValueFromPipeline)] [string[]] $DomainFilter ) Begin { if ($DetailedReport) { $Selectproperties = @( 'UserPrincipalName', 'DisplayName', 'Title', 'FirstName', 'LastName', 'StreetAddress', 'City', 'State', 'PostalCode', 'Country' 'PhoneNumber', 'MobilePhone', 'Fax', 'Department', 'Office', 'PreferredDataLocation', 'PreferredLanguage', 'SignInName', 'LiveId' 'UsageLocation', 'UserLandingPageIdentifierForO365Shell', 'ImmutableId', 'BlockCredential', 'IsLicensed', 'PasswordNeverExpires' 'PasswordResetNotRequiredDuringActivate', 'StrongPasswordRequired', 'LastDirSyncTime', 'LastPasswordChangeTimestamp' 'SoftDeletionTimestamp', 'StsRefreshTokensValidFrom', 'WhenCreated', 'ObjectId', 'CloudExchangeRecipientDisplayType' 'MSExchRecipientTypeDetails', 'StrongAuthenticationProofupTime', 'ReleaseTrack', 'UserType', 'ValidationStatus' ) $CalculatedProps = @( @{n = "AlternateEmailAddresses" ; e = { @($_.AlternateEmailAddresses) -ne '' -join '|' } }, @{n = "AlternateMobilePhones" ; e = { @($_.AlternateMobilePhones) -ne '' -join '|' } }, @{n = "AlternativeSecurityIds" ; e = { @($_.AlternativeSecurityIds) -ne '' -join '|' } }, @{n = "DirSyncProvisioningErrors" ; e = { @($_.DirSyncProvisioningErrors) -ne '' -join '|' } }, @{n = "Errors" ; e = { @($_.Errors) -ne '' -join '|' } }, @{n = "ExtensionData" ; e = { @($_.ExtensionData) -ne '' -join '|' } }, @{n = "IndirectLicenseErrors" ; e = { @($_.IndirectLicenseErrors) -ne '' -join '|' } }, @{n = "Licenses" ; e = { @($_.Licenses) -ne '' -join '|' } }, @{n = "OverallProvisioningStatus" ; e = { @($_.OverallProvisioningStatus) -ne '' -join '|' } }, @{n = "PortalSettings" ; e = { @($_.PortalSettings) -ne '' -join '|' } }, @{n = "proxyAddresses" ; e = { @($_.proxyAddresses) -ne '' -join '|' } }, @{n = "ServiceInformation" ; e = { @($_.ServiceInformation) -ne '' -join '|' } }, @{n = "MFA_State"; e = { ($_.StrongAuthenticationRequirements).State } }, @{n = "DefaultMethod"; e = { ($_.StrongAuthenticationMethods).Where( { $_.IsDefault } ).MethodType } }, @{n = "Methods"; e = { (($_.StrongAuthenticationMethods).MethodType) -join ";" } }, @{n = "MethodChoice"; e = { (($_.StrongAuthenticationMethods).IsDefault) -join ";" } }, @{n = "Auth_AlternatePhoneNumber"; e = { ($_.StrongAuthenticationUserDetails).AlternativePhoneNumber } }, @{n = "Auth_Email"; e = { ($_.StrongAuthenticationUserDetails).Email } }, @{n = "Auth_OldPin"; e = { ($_.StrongAuthenticationUserDetails).OldPin } }, @{n = "Auth_PhoneNumber"; e = { ($_.StrongAuthenticationUserDetails).PhoneNumber } }, @{n = "Auth_Pin"; e = { ($_.StrongAuthenticationUserDetails).Pin } } ) } else { $Selectproperties = @( 'UserPrincipalName', 'DisplayName', 'Title', 'FirstName', 'LastName', 'StreetAddress' 'City', 'State', 'PostalCode', 'Country', 'PhoneNumber', 'MobilePhone', 'Fax', 'Department', 'Office' 'LastDirSyncTime', 'IsLicensed' ) $CalculatedProps = @( @{n = "proxyAddresses" ; e = { @($_.proxyAddresses) -ne '' -join '|' } } ) } if ($UserPrincipalName) { Get-MsolUser -UserPrincipalName $UserPrincipalName | Select-Object ($Selectproperties + $CalculatedProps) continue } } process { if ($DomainFilter) { foreach ($CurDomainFilter in $DomainFilter) { Get-MsolUser -DomainName $CurDomainFilter -All | Select-Object ($Selectproperties + $CalculatedProps) } } else { Get-MsolUser -All | Select-Object ($Selectproperties + $CalculatedProps) } } end { } } |