PowerConfluence

0.2.0

public/api-v1/user/Invoke-ConfluenceGetUser.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
29
30
31
32
33
34
35
36
37
38
39
40
41
 $ConfluenceUserExpand = @("operations", "details.personal", "details.business", "personalSpace")

#https://developer.atlassian.com/cloud/confluence/rest/#api-api-user-get
function Invoke-ConfluenceGetUser {
    [CmdletBinding()]
    param (
        # the account id of the user to retrieve
        [Parameter(Mandatory,Position=0)]
        [string]
        $AccountId,

        # properties to expand
        [Parameter(Position=1)]
        [ValidateScript({ Compare-StringArraySubset $ConfluenceUserExpand $_ })]
        [string[]]
        $Expand,

        # The AtlassianContext object to use for the request
        [Parameter()]
        [object]
        $RequestContext
    )
    begin {
        $results = @()
    }
    process {
        $functionPath = "/wiki/rest/api/user"
        $verb = "GET"

        $query = New-PACRestMethodQueryParams @{
            accountId = $AccountId
        }
        if($PSBoundParameters.ContainsKey("Expand")){$query.Add("expand",$Expand -join ",")}

        $method = New-PACRestMethod $functionPath $verb $query
        $results += $method.Invoke($RequestContext)
    }
    end {
        $results
    }
}