Private/Get-EAMUser.ps1
|
Function Get-EAMUser { <# .DESCRIPTION This function retrieves user information from the Microsoft EAM API. The function can be used to retrieve user information based on the user ID or a filter query. The function returns the user information in the form of a PSObject. .SYNOPSIS This function retrieves user information from the Microsoft EAM API. .PARAMETER UserId The user ID of the user whose information is to be retrieved. .PARAMETER Filter The filter query to be used to retrieve user information. .PARAMETER Select The properties to be selected for the user information. The default properties are DisplayName, Id, Mail, and UserPrincipalName. .PARAMETER All Retrieve all users. .EXAMPLE Get-EAMUser -UserId "12345678-1234-1234-1234-123456789012" .EXAMPLE Get-EAMUser -Filter "startswith(displayName,'A')" .EXAMPLE Get-EAMUser -Filter "endswith(mail,'@contoso.com')" -Select "DisplayName","Id","Mail" .INPUTS System.String System.String[] System.Int32 System.Automation.SwitchParameter .OUTPUTS System.Object #> [CmdletBinding(DefaultParameterSetName="UserId")] [OutputType([System.Management.Automation.PSCustomObject])] Param ( [Parameter( Mandatory=$true,Position=0,ValueFromPipeline=$true, ValueFromPipelineByPropertyName=$true,ParameterSetName="UserId" )] [Alias( "Id","UserPrincipalName","UPN" )] [string]$UserId, [Parameter(Mandatory=$true,ParameterSetName="Filter")] [string]$Filter, [Parameter(Mandatory=$true,ParameterSetName="All")] [switch]$All, [Parameter(Mandatory=$false)] [string[]]$Select = @( "Id","UserPrincipalName","Authorizationinfo" ), [Parameter(Mandatory=$false)] [ValidateSet("Beta","v1.0")] [string]$ApiVersion = "v1.0" ) Begin { } Process { # Setting the filter based on the parameter set If ($PSCmdlet.ParameterSetName -eq "UserId") { $filter = "id eq '$userId'" } ElseIf ($PSCmdlet.ParameterSetName -eq "All") { $filter = $null } # Invoke-MgEAMRequest parameters $invoke_mg_params = @{} $invoke_mg_params["Uri"] = "https://graph.microsoft.com/$apiVersion/users?`$count=true&`$filter=$filter&`$select=$($select -join ',')" $invoke_mg_params["Method"] = "GET" $invoke_mg_params["Headers"] = @{} $invoke_mg_params["Headers"]["ConsistencyLevel"] = "eventual" $invoke_mg_params["OutputType"] = "PSObject" Try { Do { # Invoke-MgEAMRequest $r = (Invoke-MgGraphRequest @invoke_mg_params) # Return the results $r.value # Set the next link $invoke_mg_params["Uri"] = $r."@odata.nextLink" # Looping through the results until there are no more results } Until (!$r."@odata.nextLink") } Catch { Write-Error -Message $_ } } End { } } |