New-AzureADUserAppRoleAssignment

  • Referencia
Modul:
AzureAD

Hozzárendel egy felhasználót egy alkalmazásszerepkörhöz.

Syntax

New-AzureADUserAppRoleAssignment
   -ObjectId <String>
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   -Id <String>
   -PrincipalId <String>
   -ResourceId <String>
   [<CommonParameters>]

Description

A New-AzureADUserAppRoleAssignment parancsmag hozzárendel egy felhasználót egy alkalmazásszerepkörhöz az Azure Active Directoryban (AD).

Példák

1. példa: Felhasználó hozzárendelése szerepkörök nélküli alkalmazáshoz

# Get AppId of the app to assign the user to

$appId = Get-AzureADApplication -SearchString "<Your App's display name>"

# Get the user to be added

$user = Get-AzureADUser -searchstring "<Your user's UPN>"

# Get the service principal for the app you want to assign the user to

$servicePrincipal = Get-AzureADServicePrincipal -Filter "appId eq '$appId'"

# Create the user app role assignment

New-AzureADUserAppRoleAssignment -ObjectId $user.ObjectId -PrincipalId $user.ObjectId -ResourceId $servicePrincipal.ObjectId -Id ([Guid]::Empty)

Ez a parancs hozzárendel egy felhasználót a és az alkalmazáshoz, amely nem; nem rendelkezik szerepkörök.

2. példa: Felhasználó hozzárendelése egy adott szerepkörhöz egy alkalmazásban

$username = "<You user's UPN>"
$appname = "<Your App's display name>"
$spo = Get-AzureADServicePrincipal -Filter "Displayname eq '$appname'"
$user = Get-AzureADUser -ObjectId $username
New-AzureADUserAppRoleAssignment -ObjectId $user.ObjectId -PrincipalId $user.ObjectId -ResourceId $spo.ObjectId -Id $spo.Approles[1].id

Ez a parancsmag hozzárendeli a megadott felhasználóhoz azt az alkalmazásszerepkört, amelynek azonosítóját $spo. Approles[1].id. Az alkalmazásszerepkörök lekéréséről az -Id paraméter leírásában talál további információt.

Paraméterek

-Id

A hozzárendelni kívánt alkalmazásszerepkör azonosítója. Adjon meg egy üres GUID-t, amikor új alkalmazásszerepkör-hozzárendelést hoz létre egy olyan alkalmazáshoz, amely nem rendelkezik szerepkörrel, vagy adja meg a felhasználóhoz hozzárendelni kívánt szerepkör azonosítóját.

Az alkalmazás szerepköreinek lekéréséhez vizsgálja meg az alkalmazásobjektum AppRoles tulajdonságát:

Get-AzureadApplication -SearchString "Az alkalmazás megjelenítendő neve" | válassza az Approles | lehetőséget. Fl

Ez a parancsmag az alkalmazásban definiált szerepkörök listáját adja vissza:

AppRoles: {class AppRole { AllowedMemberTypes: System.Collections.Generic.List1[System.String] Description: <description for this role> DisplayName: <display name for this role> Id: 97e244a2-6ccd-4312-9de6-ecb21884c9f7 IsEnabled: True Value: Value: <That will to a token in a token for this role> } }

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-InformationAction

Meghatározza, hogy ez a parancsmag hogyan reagáljon egy információs eseményre. A paraméter elfogadható értékei a következők:

  • Folytatás
  • Kihagyás
  • Érdeklődni
  • FolytatásCsendben
  • Leállítás
  • Felfüggesztés
Type:ActionPreference
Aliases:infa
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InformationVariable

Egy információs változót ad meg.

Type:String
Aliases:iv
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ObjectId

Megadja annak a felhasználónak az azonosítóját (UPN-ként vagy ObjectId-ként) Azure AD, amelyhez az új alkalmazásszerepkört hozzá kell rendelni

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-PrincipalId

Annak a rendszerbiztonsági tagnak az objektumazonosítója, amelyhez az új alkalmazásszerepkör hozzá van rendelve. Amikor új szerepkört rendel egy felhasználóhoz, adja meg a felhasználó objektumazonosítóját.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ResourceId

Annak az alkalmazásnak az objektumazonosítója, amelyhez a felhasználói szerepkör hozzá van rendelve.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

Jegyzetek

Tekintse meg a New-AzureADUserAppRoleAssignment áttelepítési útmutatóját a Microsoft Graph PowerShellhez.