Public/Find-IAMCoreRelationship.ps1
|
<# .SYNOPSIS Finds CoreRelationship objects based on a text string. .DESCRIPTION This function searches for CoreRelationship objects in the IAM Core based on a provided text string. .EXAMPLE Find-IAMCoreRelationship -Text "john doe" #> function Find-IAMCoreRelationship { [CmdletBinding(DefaultParameterSetName = "Default")] param ( [Parameter(Mandatory = $true, ParameterSetName = "Default", Position = 0)] [ValidateLength(3, 100)] [string] $Text ) process { $Uri = "$Script:APIRoot/sync/coreobjects/relationships/search?text=$Text" Write-Verbose "Getting IAM Core relationship objects from URI: $Uri" $Result = Invoke-RestMethod -Uri $Uri -Headers (Get-IAMCoreHeader) -SkipHttpErrorCheck -StatusCodeVariable StatusCode -Verbose:$false -ConnectionTimeoutSeconds 60 -OperationTimeoutSeconds 60 if ($StatusCode -ne 200) { if ($Result.Errors) { throw "Failed to find relationships with text '$Text': $($Result.Errors -join ', ')" } else { throw "Failed to find relationships with text '$Text': Status code $StatusCode, Response: $($Result)" } } return $Result.Data } } |