Open-AzureADMSPrivilegedRoleAssignmentRequest

Module:

AzureADPreview

Créer une demande d’attribution de rôle

Syntax

Open-AzureADMSPrivilegedRoleAssignmentRequest
    -ProviderId <String>
    -ResourceId <String>
    -RoleDefinitionId <String>
    -SubjectId <String>
    -Type <String>
    -AssignmentState <String>
    -Schedule <AzureADMSPrivilegedSchedule>
    [-Reason <String>]
    [<CommonParameters>]

Description

Créer une demande d’attribution de rôle

Exemples

Exemple 1 : Créer une demande d’attribution de rôle éligible

$schedule = New-Object Microsoft.Open.MSGraph.Model.AzureADMSPrivilegedSchedule
$schedule.Type = "Once"
$schedule.StartDateTime = "2019-04-26T20:49:11.770Z"
$schedule.endDateTime = "2019-07-25T20:49:11.770Z"
Open-AzureADMSPrivilegedRoleAssignmentRequest -ProviderId AzureResources -Schedule $schedule -ResourceId "e5e7d29d-5465-45ac-885f-4716a5ee74b5" -RoleDefinitionId "9f8c1837-f885-4dfd-9a75-990f9222b21d" -SubjectId "a25004a3-eceb-4ad4-b4aa-9485356bc55b" -AssignmentState "Eligible" -Type "AdminAdd"

Cet exemple crée une demande d’attribution de rôle.

Exemple 2 : Activer une attribution de rôle éligible pendant 4 heures

$Duration = 4 # Number in Hours
$Date = Get-Date
$start = $Date.ToUniversalTime()
$end = $Date.AddHours($Duration).ToUniversalTime()

$schedule = New-Object Microsoft.Open.MSGraph.Model.AzureADMSPrivilegedSchedule
$schedule.Type = 'Once'
$schedule.StartDateTime = $start.ToString('yyyy-MM-ddTHH:mm:ss.fffZ')
$schedule.endDateTime = $end.ToString('yyyy-MM-ddTHH:mm:ss.fffZ')

Open-AzureADMSPrivilegedRoleAssignmentRequest -ProviderId AzureResources -Schedule $schedule -ResourceId "e5e7d29d-5465-45ac-885f-4716a5ee74b5" -RoleDefinitionId "9f8c1837-f885-4dfd-9a75-990f9222b21d" -SubjectId "a25004a3-eceb-4ad4-b4aa-9485356bc55b" -AssignmentState "Active" -Type "UserAdd"

Cet exemple crée une demande d’attribution de rôle activant le rôle Administration.

Exemple 3 : Désactiver une attribution de rôle actuellement active

$Duration = 0 # Disables the role immediately
$Date = Get-Date
$start = $Date.ToUniversalTime()
$end = $Date.AddHours($Duration).ToUniversalTime()

$schedule = New-Object Microsoft.Open.MSGraph.Model.AzureADMSPrivilegedSchedule
$schedule.Type = 'Once'
$schedule.StartDateTime = $start.ToString('yyyy-MM-ddTHH:mm:ss.fffZ')
$schedule.endDateTime = $end.ToString('yyyy-MM-ddTHH:mm:ss.fffZ')

Open-AzureADMSPrivilegedRoleAssignmentRequest -ProviderId AzureResources -Schedule $schedule -ResourceId "e5e7d29d-5465-45ac-885f-4716a5ee74b5" -RoleDefinitionId "9f8c1837-f885-4dfd-9a75-990f9222b21d" -SubjectId "a25004a3-eceb-4ad4-b4aa-9485356bc55b" -AssignmentState "Active" -Type "UserRemove"

Cet exemple crée une demande d’attribution de rôle désactivant le rôle Administration.

Paramètres

-AssignmentState

État de l’affectation. La valeur peut être Éligible et Active. Obligatoire.

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

-ProviderId

Identificateur unique du fournisseur spécifique

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

-Reason

La raison doit être fournie pour la demande d’attribution de rôle à des fins d’audit et de révision.

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

-ResourceId

Identificateur unique de la ressource spécifique

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

-RoleDefinitionId

ID de la définition de rôle. Obligatoire.

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

-Schedule

Planification de la demande d’attribution de rôle. Pour les types de requête UserAdd, AdminAdd, AdminUpdate et AdminExtend, il est obligatoire.

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

-SubjectId

ID de l’objet. Obligatoire.

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

-Type

Type de requête. La valeur peut être AdminAdd, UserAdd, AdminUpdate, AdminRemove, UserRemove, UserExtend, UserRenew, AdminRenew et AdminExtend. Obligatoire.

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

Entrées

String

Sorties

Object

Liens associés

• Attribuer des rôles Azure AD dans Privileged Identity Management à l’aide de Microsoft Graph PowerShell