Update-MgBetaEducationMeRubric

Module:

Microsoft.Graph.Beta.Education

Update the properties of an educationRubric object. Only teachers can perform this operation. Updating a rubric attached to an assignment (PATCH /education/classes/{id}/assignments/{id}/rubric) is only possible before the assignment is published, and what is updated is actually the original rubric that exists under /education/users/{id}/rubrics. After the assignment is published, an immutable copy of the rubric is made that is attached to that specific assignment. That rubric can be retrieved using GET /education/classes/{id}/assignments/{id}/rubric, but it can't be updated.

Note

To view the v1.0 release of this cmdlet, view Update-MgEducationMeRubric

Syntax

Update-MgBetaEducationMeRubric
      -EducationRubricId <String>
      [-ResponseHeadersVariable <String>]
      [-AdditionalProperties <Hashtable>]
      [-CreatedBy <IMicrosoftGraphIdentitySet>]
      [-Description <IMicrosoftGraphEducationItemBody>]
      [-DisplayName <String>]
      [-Grading <Hashtable>]
      [-Id <String>]
      [-LastModifiedBy <IMicrosoftGraphIdentitySet>]
      [-Levels <IMicrosoftGraphRubricLevel[]>]
      [-Qualities <IMicrosoftGraphRubricQuality[]>]
      [-Headers <IDictionary>]
      [-ProgressAction <ActionPreference>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Update-MgBetaEducationMeRubric
      -EducationRubricId <String>
      -BodyParameter <IMicrosoftGraphEducationRubric>
      [-ResponseHeadersVariable <String>]
      [-Headers <IDictionary>]
      [-ProgressAction <ActionPreference>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Update-MgBetaEducationMeRubric
      -InputObject <IEducationIdentity>
      [-ResponseHeadersVariable <String>]
      [-AdditionalProperties <Hashtable>]
      [-CreatedBy <IMicrosoftGraphIdentitySet>]
      [-Description <IMicrosoftGraphEducationItemBody>]
      [-DisplayName <String>]
      [-Grading <Hashtable>]
      [-Id <String>]
      [-LastModifiedBy <IMicrosoftGraphIdentitySet>]
      [-Levels <IMicrosoftGraphRubricLevel[]>]
      [-Qualities <IMicrosoftGraphRubricQuality[]>]
      [-Headers <IDictionary>]
      [-ProgressAction <ActionPreference>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Update-MgBetaEducationMeRubric
      -InputObject <IEducationIdentity>
      -BodyParameter <IMicrosoftGraphEducationRubric>
      [-ResponseHeadersVariable <String>]
      [-Headers <IDictionary>]
      [-ProgressAction <ActionPreference>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

Update the properties of an educationRubric object. Only teachers can perform this operation. Updating a rubric attached to an assignment (PATCH /education/classes/{id}/assignments/{id}/rubric) is only possible before the assignment is published, and what is updated is actually the original rubric that exists under /education/users/{id}/rubrics. After the assignment is published, an immutable copy of the rubric is made that is attached to that specific assignment. That rubric can be retrieved using GET /education/classes/{id}/assignments/{id}/rubric, but it can't be updated.

Permissions

Permission type	Permissions (from least to most privileged)
Delegated (work or school account)	EduAssignments.ReadWriteBasic, EduAssignments.ReadWrite,
Delegated (personal Microsoft account)	Not supported
Application	Not supported

Examples

Example 1: Code snippet

Import-Module Microsoft.Graph.Beta.Education

$params = @{
	displayName = "Example Credit Rubric after display name patch"
}

Update-MgBetaEducationMeRubric -EducationRubricId $educationRubricId -BodyParameter $params

This example shows how to use the Update-MgBetaEducationMeRubric Cmdlet.

Parameters

-AdditionalProperties

Additional Parameters

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

-BodyParameter

educationRubric To construct, see NOTES section for BODYPARAMETER properties and create a hash table.

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

-Confirm

Prompts you for confirmation before running the cmdlet.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-CreatedBy

identitySet To construct, see NOTES section for CREATEDBY properties and create a hash table.

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

-Description

educationItemBody To construct, see NOTES section for DESCRIPTION properties and create a hash table.

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

-DisplayName

The name of this rubric.

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

-EducationRubricId

The unique identifier of educationRubric

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

-Grading

educationAssignmentGradeType

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

-Headers

Optional headers that will be added to the request.

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

-Id

The unique identifier for an entity. Read-only.

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

-InputObject

Identity Parameter To construct, see NOTES section for INPUTOBJECT properties and create a hash table.

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

-LastModifiedBy

identitySet To construct, see NOTES section for LASTMODIFIEDBY properties and create a hash table.

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

-Levels

The collection of levels making up this rubric. To construct, see NOTES section for LEVELS properties and create a hash table.

Type:	IMicrosoftGraphRubricLevel[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ProgressAction

{{ Fill ProgressAction Description }}

Type:	ActionPreference
Aliases:	proga
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Qualities

The collection of qualities making up this rubric. To construct, see NOTES section for QUALITIES properties and create a hash table.

Type:	IMicrosoftGraphRubricQuality[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ResponseHeadersVariable

Optional Response Headers Variable.

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

-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Inputs

Microsoft.Graph.Beta.PowerShell.Models.IEducationIdentity

Microsoft.Graph.Beta.PowerShell.Models.IMicrosoftGraphEducationRubric

System.Collections.IDictionary

Outputs

Microsoft.Graph.Beta.PowerShell.Models.IMicrosoftGraphEducationRubric

Notes

COMPLEX PARAMETER PROPERTIES

To create the parameters described below, construct a hash table containing the appropriate properties. For information on hash tables, run Get-Help about_Hash_Tables.

BODYPARAMETER <IMicrosoftGraphEducationRubric>: educationRubric

• [(Any) <Object>]: This indicates any property can be added to this object.
• [Id <String>]: The unique identifier for an entity. Read-only.
• [CreatedBy <IMicrosoftGraphIdentitySet>]: identitySet
  • [(Any) <Object>]: This indicates any property can be added to this object.
  • [Application <IMicrosoftGraphIdentity>]: identity
    • [(Any) <Object>]: This indicates any property can be added to this object.
    • [DisplayName <String>]: The display name of the identity. This property is read-only.
    • [Id <String>]: The identifier of the identity. This property is read-only.
  • [Device <IMicrosoftGraphIdentity>]: identity
  • [User <IMicrosoftGraphIdentity>]: identity
• [Description <IMicrosoftGraphEducationItemBody>]: educationItemBody
  • [(Any) <Object>]: This indicates any property can be added to this object.
  • [Content <String>]:
  • [ContentType <String>]: bodyType
• [DisplayName <String>]: The name of this rubric.
• [Grading <IMicrosoftGraphEducationAssignmentGradeType>]: educationAssignmentGradeType
  • [(Any) <Object>]: This indicates any property can be added to this object.
• [LastModifiedBy <IMicrosoftGraphIdentitySet>]: identitySet
• [Levels <IMicrosoftGraphRubricLevel- []>]: The collection of levels making up this rubric.
  • [Description <IMicrosoftGraphEducationItemBody>]: educationItemBody
  • [DisplayName <String>]: The name of this rubric level.
  • [Grading <IMicrosoftGraphEducationAssignmentGradeType>]: educationAssignmentGradeType
  • [LevelId <String>]: The ID of this resource.
• [Qualities <IMicrosoftGraphRubricQuality- []>]: The collection of qualities making up this rubric.
  • [Criteria <IMicrosoftGraphRubricCriterion- []>]: The collection of criteria for this rubric quality.
    • [Description <IMicrosoftGraphEducationItemBody>]: educationItemBody
  • [Description <IMicrosoftGraphEducationItemBody>]: educationItemBody
  • [DisplayName <String>]: The name of this rubric quality.
  • [QualityId <String>]: The ID of this resource.
  • [Weight <Single?>]: If present, a numerical weight for this quality. Weights must add up to 100.

CREATEDBY <IMicrosoftGraphIdentitySet>: identitySet

• [(Any) <Object>]: This indicates any property can be added to this object.
• [Application <IMicrosoftGraphIdentity>]: identity
  • [(Any) <Object>]: This indicates any property can be added to this object.
  • [DisplayName <String>]: The display name of the identity. This property is read-only.
  • [Id <String>]: The identifier of the identity. This property is read-only.
• [Device <IMicrosoftGraphIdentity>]: identity
• [User <IMicrosoftGraphIdentity>]: identity

DESCRIPTION <IMicrosoftGraphEducationItemBody>: educationItemBody

• [(Any) <Object>]: This indicates any property can be added to this object.
• [Content <String>]:
• [ContentType <String>]: bodyType

INPUTOBJECT <IEducationIdentity>: Identity Parameter

• [EducationAssignmentId <String>]: The unique identifier of educationAssignment
• [EducationAssignmentResourceId <String>]: The unique identifier of educationAssignmentResource
• [EducationAssignmentResourceId1 <String>]: The unique identifier of educationAssignmentResource
• [EducationCategoryId <String>]: The unique identifier of educationCategory
• [EducationClassId <String>]: The unique identifier of educationClass
• [EducationGradingCategoryId <String>]: The unique identifier of educationGradingCategory
• [EducationGradingSchemeId <String>]: The unique identifier of educationGradingScheme
• [EducationModuleId <String>]: The unique identifier of educationModule
• [EducationModuleResourceId <String>]: The unique identifier of educationModuleResource
• [EducationOutcomeId <String>]: The unique identifier of educationOutcome
• [EducationRubricId <String>]: The unique identifier of educationRubric
• [EducationSchoolId <String>]: The unique identifier of educationSchool
• [EducationSubmissionId <String>]: The unique identifier of educationSubmission
• [EducationSubmissionResourceId <String>]: The unique identifier of educationSubmissionResource
• [EducationSubmissionResourceId1 <String>]: The unique identifier of educationSubmissionResource
• [EducationUserId <String>]: The unique identifier of educationUser
• [ReadingAssignmentSubmissionId <String>]: The unique identifier of readingAssignmentSubmission
• [ReflectCheckInResponseId <String>]: The unique identifier of reflectCheckInResponse

LASTMODIFIEDBY <IMicrosoftGraphIdentitySet>: identitySet

• [(Any) <Object>]: This indicates any property can be added to this object.
• [Application <IMicrosoftGraphIdentity>]: identity
  • [(Any) <Object>]: This indicates any property can be added to this object.
  • [DisplayName <String>]: The display name of the identity. This property is read-only.
  • [Id <String>]: The identifier of the identity. This property is read-only.
• [Device <IMicrosoftGraphIdentity>]: identity
• [User <IMicrosoftGraphIdentity>]: identity

LEVELS <IMicrosoftGraphRubricLevel- []>: The collection of levels making up this rubric.

• [Description <IMicrosoftGraphEducationItemBody>]: educationItemBody
  • [(Any) <Object>]: This indicates any property can be added to this object.
  • [Content <String>]:
  • [ContentType <String>]: bodyType
• [DisplayName <String>]: The name of this rubric level.
• [Grading <IMicrosoftGraphEducationAssignmentGradeType>]: educationAssignmentGradeType
  • [(Any) <Object>]: This indicates any property can be added to this object.
• [LevelId <String>]: The ID of this resource.

QUALITIES <IMicrosoftGraphRubricQuality- []>: The collection of qualities making up this rubric.

• [Criteria <IMicrosoftGraphRubricCriterion- []>]: The collection of criteria for this rubric quality.
  • [Description <IMicrosoftGraphEducationItemBody>]: educationItemBody
    • [(Any) <Object>]: This indicates any property can be added to this object.
    • [Content <String>]:
    • [ContentType <String>]: bodyType
• [Description <IMicrosoftGraphEducationItemBody>]: educationItemBody
• [DisplayName <String>]: The name of this rubric quality.
• [QualityId <String>]: The ID of this resource.
• [Weight <Single?>]: If present, a numerical weight for this quality. Weights must add up to 100.

Related Links

• https://learn.microsoft.com/powershell/module/microsoft.graph.beta.education/update-mgbetaeducationmerubric
• https://learn.microsoft.com/graph/api/educationrubric-update?view=graph-rest-beta