New-ImpersonationGroup
SYNOPSIS
Create a new impersonation group for application impersonation.
SYNTAX
DESCRIPTION
The `New-ImpersonationGroup` function creates a new Active Directory group and management scope for application impersonation. It validates the specified user, ensures the group and scope do not already exist, and assigns the ApplicationImpersonation role.
EXAMPLES
EXAMPLE 1
Creates a new impersonation group and scope for the user `appimp_user` and logs the action with task number 12345.
PARAMETERS
-sysuser
The system user for whom the impersonation group will be created.
Type: Object
Parameter Sets: (All)
Aliases:
Required: True
Position: 1
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-HEATTaskNumber
The task number associated with the creation of the impersonation group, used for logging purposes.
Type: Int32
Parameter Sets: (All)
Aliases:
Required: True
Position: 2
Default value: 0
Accept pipeline input: False
Accept wildcard characters: False
CommonParameters
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.