Users affected by moving group

Get-IAMGroupMoveAffectedUsers

Synopsis

Get users affected by moving a group.

Syntax

Get-IAMGroupMoveAffectedUsers [-SourceGroupID] <Int32> [-DestinationGroupID] <Int32> [[-UserType] <String>] [[-EdgeRCFile] <String>] [[-Section] <String>] [[-AccountSwitchKey] <String>] [-ProgressAction <ActionPreference>] [<CommonParameters>]

Description

Gets users who are affected when you move a group. Users may lose or gain access to resources depending on the roles and permissions inherited from the new parent group. Users with a -UserType of lostAccess lose their access to the source group. If the -UserType is gainAccess, they gain access to the resources in the source group.

Users who have inherited access to a group lose access to that group if it moves out of its hierarchy that gives them those access rights.

If the group moves to another parent group to which they have access, they still have access to the group you move. Likewise, when you move a group to a new location, users who inherit their access rights from the new parent group gain access to the resources in the group you move.

Parameters

‑AccountSwitchKey

An account credential key that lets you move between accounts when using an API client enabled for multiple accounts. To find account switch keys, use Get-AccountSwitchKey.

‑DestinationGroupID
Required

The ID of the destination group you're putting the source group into.

‑EdgeRCFile

Your EdgeGrid resource file to authenticate your command. Defaults to ~/.edgerc.

‑Section

The section name in your EdgeGrid resource file to retrieve authentication credentials from. Defaults to default.

‑SourceGroupID
Required

The ID of a group you want to move.

‑UserType

Filters the list by users who have lostAccess or the reverse gainAccess.

Related Links