Functions/Groups/Get-GraphGroup.ps1

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
Function Get-GraphGroup
{
    [CmdletBinding()]
    Param(      
        [Parameter(Mandatory = $true,
                   ValueFromPipeline = $true,
                   ValueFromPipelineByPropertyName = $true)]
        [ValidateNotNullOrEmpty()]
        [string[]]$GroupId = @()
    )

    Process
    {
        foreach ($singleGroupId in $GroupId)
        {
            $emptyGuid = [guid]::Empty
            if ([guid]::TryParse($singleGroupId, [ref]$emptyGuid))
            {
                $uri = $global:PowerGraph_BaseUrl + "groups/$singleGroupId"
                return Invoke-MSGraphRequest -Uri $uri
            }
            else
            {
                throw "Invalid Group ID - $singleGroupId"
            }
        }
    }
}