New-EntraGroupAppRoleAssignment

Module:
Microsoft.Entra.Groups Module v1.3

Wijs een groep gebruikers toe aan een toepassingsrol.

Syntax

Default (Standaard) 

New-EntraGroupAppRoleAssignment

    -GroupId <String>
    -PrincipalId <String>
    -AppRoleId <String>
    -ResourceId <String>
    [<CommonParameters>]

Description

Met de New-EntraGroupAppRoleAssignment cmdlet wordt een groep gebruikers toegewezen aan een toepassingsrol in Microsoft Entra ID.

Voorbeelden

Voorbeeld 1: Een groep gebruikers toewijzen aan een toepassing

Connect-Entra -Scopes 'AppRoleAssignment.ReadWrite.All'
$servicePrincipal = Get-EntraServicePrincipal -Filter "Displayname eq 'Box'"
$group = Get-EntraGroup -SearchString 'Contoso Global'
New-EntraGroupAppRoleAssignment -GroupId $group.Id -PrincipalId $group.Id -ResourceId $servicePrincipal.Id -AppRoleId $servicePrincipal.Approles[1].Id

DeletedDateTime        Id                                          AppRoleId                            CreatedDateTime      PrincipalDisplayName PrincipalId
---------------        --                                          ---------                            ---------------      -------------------- -----------
                      AaBbCcDdEeFfGgHhIiJjKkLlMmNnOo1 00000000-0000-0000-0000-000000000000 3/13/2024 4:41:43 AM Contoso Team         aaaaaaaa-bbbb-cccc-1111-222222222222
3/13/2024 4:45:00 AM  BbCcDdEeFfGgHhIiJjKkLlMmNnOoPp2 00000000-0000-0000-0000-000000000000 3/13/2024 4:45:00 AM Finance Group        bbbbbbbb-cccc-dddd-2222-333333333333

In dit voorbeeld ziet u hoe u een groep gebruikers toewijst aan een toepassingsrol in Microsoft Entra ID.

  • GroupId: De id van de groep waaraan u de app-rol toewijst.
  • PrincipalId: De id van de groep waaraan u de app-rol toewijst.
  • ResourceId: De id van de resourceservice-principal, die de app-rol heeft gedefinieerd.
  • AppRoleId: De id van de appRole (gedefinieerd in de resourceservice-principal) die moet worden toegewezen aan de groep.

Parameters

-AppRoleId

Hiermee geeft u de id op van de app-rol (gedefinieerd in de resourceservice-principal) die moet worden toegewezen.

Parametereigenschappen

Type:System.String
Default value:None
Ondersteunt jokertekens:False
DontShow:False
Aliassen:Id

Parametersets

(All)
Position:Named
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-GroupId

Hiermee geeft u de id van een groep in Microsoft Entra ID.

Parametereigenschappen

Type:System.String
Default value:None
Ondersteunt jokertekens:False
DontShow:False
Aliassen:ObjectId

Parametersets

(All)
Position:Named
Verplicht:True
Waarde uit pijplijn:True
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-PrincipalId

Hiermee geeft u de principal-id op.

Parametereigenschappen

Type:System.String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-ResourceId

De unieke id (ID) voor de resourceservice-principal waarvoor de toewijzing wordt gemaakt. Vereist bij maken. Ondersteunt $filter (alleen eq).

Parametereigenschappen

Type:System.String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

CommonParameters

Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.