Skip to content

Get-CIPPDirectoryObjects.md

Latest commit

 

History

History
37 lines (30 loc) · 2.07 KB

Get-CIPPDirectoryObjects.md

File metadata and controls

37 lines (30 loc) · 2.07 KB

Get-CIPPDirectoryObjects

SYNOPSIS

Retrieves directory objects by their IDs from Microsoft Graph.

DESCRIPTION

The Get-CIPPDirectoryObjects function retrieves directory objects (users, groups, devices, etc.) by their IDs from Microsoft Graph. This is useful for batch lookups of multiple objects at once. You can optionally specify which properties to return.

PARAMETERS

-CustomerTenantID

Foo Foo
Specifies the ID of the customer tenant. This parameter is mandatory.

-Ids

Foo Foo
Specifies an array of directory object IDs to retrieve. This parameter is mandatory.

-Select

Foo Foo
Specifies the properties to return for each directory object. This parameter is optional. If not provided, all properties will be returned.

-AsApp

Foo Foo Foo
Specifies whether to use application permissions instead of delegated permissions. This parameter is optional.

-PartnerLookup

Foo Foo Foo
Specifies whether to perform a lookup in the partner tenant. This parameter is optional.

EXAMPLE 1

PS > Get-CIPPDirectoryObjects -CustomerTenantID "contoso.onmicrosoft.com" -Ids @("12345678-1234-1234-1234-123456789012", "87654321-4321-4321-4321-210987654321")

EXAMPLE 2

PS > Get-CIPPDirectoryObjects -CustomerTenantID "contoso.onmicrosoft.com" -Ids @("12345678-1234-1234-1234-123456789012") -Select "displayName,userPrincipalName"