custom/Get-MgEntitlementManagementAccessPackage.ps1
|
# ---------------------------------------------------------------------------------- # # Copyright Microsoft Corporation # Licensed under the Apache License, Version 2.0 (the "License"); # you may not use this file except in compliance with the License. # You may obtain a copy of the License at # http://www.apache.org/licenses/LICENSE-2.0 # Unless required by applicable law or agreed to in writing, software # distributed under the License is distributed on an "AS IS" BASIS, # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. # See the License for the specific language governing permissions and # limitations under the License. # ---------------------------------------------------------------------------------- <# .Synopsis Get accessPackages from identityGovernance .Description Get accessPackages from identityGovernance .Example PS C:\> {{ Add code here }} {{ Add output here }} .Example PS C:\> {{ Add code here }} {{ Add output here }} .Inputs Microsoft.Graph.PowerShell.Models.IIdentityGovernanceIdentity .Outputs Microsoft.Graph.PowerShell.Models.IMicrosoftGraphAccessPackage .Notes .Link https://docs.microsoft.com/en-us/powershell/module/microsoft.graph.identity.governance/get-mgentitlementmanagementaccesspackage #> function Get-MgEntitlementManagementAccessPackage { [OutputType([Microsoft.Graph.PowerShell.Models.IMicrosoftGraphAccessPackage])] [CmdletBinding(DefaultParameterSetName='ListAll', PositionalBinding=$false)] param( [Parameter()] [Alias('Expand')] [Microsoft.Graph.PowerShell.Category('Query')] [System.String[]] # Expand related entities ${ExpandProperty}, [Parameter()] [Alias('Select')] [Microsoft.Graph.PowerShell.Category('Query')] [System.String[]] # Select properties to be returned ${Property}, [Parameter(ParameterSetName='ListByCatalogId', Mandatory)] [Microsoft.Graph.PowerShell.Category('Query')] [ValidateScript( { try { [System.Guid]::Parse($_) | Out-Null $true } catch { throw "$_ is not a valid ObjectID format. Valid value is a GUID format only." } })] [System.String] # Filter items by property values ${CatalogId}, [Parameter(ParameterSetName='ListByDisplayNameEq', Mandatory)] [Microsoft.Graph.PowerShell.Category('Query')] [System.String] # Filter items by property values ${DisplayNameEq}, [Parameter(ParameterSetName='ListByDisplayNameContains', Mandatory)] [Microsoft.Graph.PowerShell.Category('Query')] [System.String] # Filter items by property values ${DisplayNameContains}, [Parameter(ParameterSetName='ListAll')] [Parameter(ParameterSetName='ListByCatalogId')] [Parameter(ParameterSetName='ListByDisplayNameEq')] [Parameter(ParameterSetName='ListByDisplayNameContains')] [Alias('OrderBy')] [Microsoft.Graph.PowerShell.Category('Query')] [System.String[]] # Order items by property values ${Sort}, [Parameter(ParameterSetName='ListByDisplayNameEq')] [Parameter(ParameterSetName='ListByDisplayNameContains')] [Parameter(ParameterSetName='ListByCatalogId')] [Alias('Limit')] [Microsoft.Graph.PowerShell.Category('Query')] [System.Int32] # Show only the first n items ${Top}, [Parameter(DontShow)] [Microsoft.Graph.PowerShell.Category('Runtime')] [System.Management.Automation.SwitchParameter] # Wait for .NET debugger to attach ${Break}, [Parameter(DontShow)] [ValidateNotNull()] [Microsoft.Graph.PowerShell.Category('Runtime')] [Microsoft.Graph.PowerShell.Runtime.SendAsyncStep[]] # SendAsync Pipeline Steps to be appended to the front of the pipeline ${HttpPipelineAppend}, [Parameter(DontShow)] [ValidateNotNull()] [Microsoft.Graph.PowerShell.Category('Runtime')] [Microsoft.Graph.PowerShell.Runtime.SendAsyncStep[]] # SendAsync Pipeline Steps to be prepended to the front of the pipeline ${HttpPipelinePrepend}, [Parameter(DontShow)] [Microsoft.Graph.PowerShell.Category('Runtime')] [System.Uri] # The URI for the proxy server to use ${Proxy}, [Parameter(DontShow)] [ValidateNotNull()] [Microsoft.Graph.PowerShell.Category('Runtime')] [System.Management.Automation.PSCredential] # Credentials for a proxy server to use for the remote call ${ProxyCredential}, [Parameter(DontShow)] [Microsoft.Graph.PowerShell.Category('Runtime')] [System.Management.Automation.SwitchParameter] # Use the default credentials for the proxy ${ProxyUseDefaultCredentials}, [Parameter(ParameterSetName='ListAll')] [Parameter(ParameterSetName='ListByDisplayNameEq')] [Parameter(ParameterSetName='ListByDisplayNameContains')] [Parameter(ParameterSetName='ListByCatalogId')] [Microsoft.Graph.PowerShell.Category('Runtime')] [System.Management.Automation.SwitchParameter] # List all pages. ${All} ) begin { } process { $outBuffer = $null if ($PSBoundParameters.TryGetValue('OutBuffer', [ref]$outBuffer)) { $PSBoundParameters['OutBuffer'] = 1 } $parameterSet = $PSCmdlet.ParameterSetName if ($parameterSet -eq "ListByDisplayNameEq") { $Filter = "displayName eq '{0}'" -f $DisplayNameEq $PSBoundParameters['Filter'] = $Filter $null = $PSBoundParameters.Remove('DisplayNameEq') } elseif ($parameterSet -eq "ListByDisplayNameContains") { $Filter = "contains(tolower(displayName), '{0}')" -f $DisplayNameContains $PSBoundParameters['Filter'] = $Filter $null = $PSBoundParameters.Remove('DisplayNameContains') } elseif ($parameterSet -eq "ListByCatalogId") { # use "accessPackageCatalog/Id" for beta, "catalog/Id" for v1.0 $mgp = Get-MgProfile if ($null -ne $mgp -and $mgp.Name -eq "beta") { $Filter = "accessPackageCatalog/Id eq '{0}'" -f $CatalogId } else { $Filter = "catalog/Id eq '{0}'" -f $CatalogId } $PSBoundParameters['Filter'] = $Filter $null = $PSBoundParameters.Remove('CatalogId') } if ($PSBoundParameters.ContainsKey('Top') -or $PSBoundParameters.ContainsKey('All')) { } else { $PSBoundParameters['All'] = $true } Microsoft.Graph.Identity.Governance.private\Get-MgEntitlementManagementAccessPackage_List @PSBoundParameters } end { } } |