New-MsIdAgentIDForAgentIdentityBlueprint

SYNOPSIS

Creates a new Agent Identity using an Agent Identity Blueprint

SYNTAX

New-MsIdAgentIDForAgentIdentityBlueprint [[-DisplayName] <String>] [[-SponsorUserIds] <String[]>]
 [[-SponsorGroupIds] <String[]>] [[-OwnerUserIds] <String[]>] [-ProgressAction <ActionPreference>]
 [<CommonParameters>]

DESCRIPTION

Creates a new Agent Identity by posting to the Microsoft Graph AgentIdentity endpoint using the current Agent Identity Blueprint ID and specified sponsors/owners

EXAMPLES

EXAMPLE 1

New-MsIdAgentIDForAgentIdentityBlueprint -DisplayName "My Agent Identity" -SponsorUserIds @("user1") -OwnerUserIds @("owner1")

EXAMPLE 2

New-MsIdAgentIDForAgentIdentityBlueprint  # Will prompt for all required parameters

PARAMETERS

-DisplayName

The display name for the Agent Identity

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: 1
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-SponsorUserIds

Array of user IDs to set as sponsors

Type: String[]
Parameter Sets: (All)
Aliases:

Required: False
Position: 2
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-SponsorGroupIds

Array of group IDs to set as sponsors

Type: String[]
Parameter Sets: (All)
Aliases:

Required: False
Position: 3
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-OwnerUserIds

Array of user IDs to set as owners

Type: String[]
Parameter Sets: (All)
Aliases:

Required: False
Position: 4
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-ProgressAction

{{ Fill ProgressAction Description }}

Type: ActionPreference
Parameter Sets: (All)
Aliases: proga

Required: False
Position: Named
Default value: None
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.

INPUTS

OUTPUTS

NOTES

Requires an Agent Identity Blueprint to be created first (uses stored blueprint ID) At least one owner or sponsor (user or group) must be specified

RELATED LINKS