Update an educationAssignment object.
Only teachers can perform this action.
Alternatively, request to change the status of an assignment with publish action.
Don't use a PATCH operation for this purpose.
Update an educationAssignment object.
Only teachers can perform this action.
Alternatively, request to change the status of an assignment with publish action.
Don't use a PATCH operation for this purpose.
When set, enables users to easily find assignments of a given type.
Read-only.
Nullable.
To construct, see NOTES section for CATEGORIES properties and create a hash table.
Date when the assignment is closed for submissions.
This is an optional field that can be null if the assignment doesn't allowLateSubmissions or when the closeDateTime is the same as the dueDateTime.
But if specified, then the closeDateTime must be greater than or equal to the dueDateTime.
The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time.
For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z
Parameter properties
Type:
System.DateTime
Supports wildcards:
False
DontShow:
False
Parameter sets
UpdateViaIdentityExpanded
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
UpdateExpanded
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
-Confirm
Prompts you for confirmation before running the cmdlet.
Parameter properties
Type:
System.Management.Automation.SwitchParameter
Supports wildcards:
False
DontShow:
False
Aliases:
cf
Parameter sets
(All)
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
-CreatedBy
identitySet
To construct, see NOTES section for CREATEDBY properties and create a hash table.
Date when the students assignment is due.
The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time.
For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z
Parameter properties
Type:
System.DateTime
Supports wildcards:
False
DontShow:
False
Parameter sets
UpdateViaIdentityExpanded
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
UpdateExpanded
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
-EducationAssignmentId
The unique identifier of educationAssignment
Parameter properties
Type:
System.String
Supports wildcards:
False
DontShow:
False
Parameter sets
UpdateExpanded
Position:
Named
Mandatory:
True
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
Update
Position:
Named
Mandatory:
True
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
-EducationClassId
The unique identifier of educationClass
Parameter properties
Type:
System.String
Supports wildcards:
False
DontShow:
False
Parameter sets
UpdateExpanded
Position:
Named
Mandatory:
True
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
Update
Position:
Named
Mandatory:
True
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
-Grading
educationAssignmentGradeType
Parameter properties
Type:
System.Collections.Hashtable
Supports wildcards:
False
DontShow:
False
Parameter sets
UpdateViaIdentityExpanded
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
UpdateExpanded
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
-GradingCategory
educationGradingCategory
To construct, see NOTES section for GRADINGCATEGORY properties and create a hash table.
The URL of the module from which to access the assignment.
Parameter properties
Type:
System.String
Supports wildcards:
False
DontShow:
False
Parameter sets
UpdateViaIdentityExpanded
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
UpdateExpanded
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
-NotificationChannelUrl
Optional field to specify the URL of the channel to post the assignment publish notification.
If not specified or null, defaults to the General channel.
This field only applies to assignments where the assignTo value is educationAssignmentClassRecipient.
Updating the notificationChannelUrl isn't allowed after the assignment is published.
Parameter properties
Type:
System.String
Supports wildcards:
False
DontShow:
False
Parameter sets
UpdateViaIdentityExpanded
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
UpdateExpanded
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
-Proxy
The URI for the proxy server to use
Parameter properties
Type:
System.Uri
Supports wildcards:
False
DontShow:
False
Parameter sets
(All)
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
-ProxyCredential
Credentials for a proxy server to use for the remote call
Parameter properties
Type:
System.Management.Automation.PSCredential
Supports wildcards:
False
DontShow:
False
Parameter sets
(All)
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
-ProxyUseDefaultCredentials
Use the default credentials for the proxy
Parameter properties
Type:
System.Management.Automation.SwitchParameter
Default value:
False
Supports wildcards:
False
DontShow:
False
Parameter sets
(All)
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
-Resources
Learning objects that are associated with this assignment.
Only teachers can modify this list.
Nullable.
To construct, see NOTES section for RESOURCES properties and create a hash table.
Once published, there's a submission object for each student representing their work and grade.
Read-only.
Nullable.
To construct, see NOTES section for SUBMISSIONS properties and create a hash table.
Runs the command in a mode that only reports what would happen without performing the actions.
Parameter properties
Type:
System.Management.Automation.SwitchParameter
Supports wildcards:
False
DontShow:
False
Aliases:
wi
Parameter sets
(All)
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
CommonParameters
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable,
-InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable,
-ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see
about_CommonParameters.
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 <IMicrosoftGraphEducationAssignment>: educationAssignment
[(Any) <Object>]: This indicates any property can be added to this object.
[Id <String>]: The unique identifier for an entity.
Read-only.
[AddToCalendarAction <String>]: educationAddToCalendarOptions
[AddedStudentAction <String>]: educationAddedStudentAction
[AllowLateSubmissions <Boolean?>]: Identifies whether students can submit after the due date.
If this property isn't specified during create, it defaults to true.
[AllowStudentsToAddResourcesToSubmission <Boolean?>]: Identifies whether students can add their own resources to a submission or if they can only modify resources added by the teacher.
[AssignTo <IMicrosoftGraphEducationAssignmentRecipient>]: educationAssignmentRecipient
[(Any) <Object>]: This indicates any property can be added to this object.
[Categories <IMicrosoftGraphEducationCategory[]>]: When set, enables users to easily find assignments of a given type.
Read-only.
Nullable.
[Id <String>]: The unique identifier for an entity.
Read-only.
[DisplayName <String>]: Unique identifier for the category.
[ClassId <String>]: Class to which this assignment belongs.
[CloseDateTime <DateTime?>]: Date when the assignment is closed for submissions.
This is an optional field that can be null if the assignment doesn't allowLateSubmissions or when the closeDateTime is the same as the dueDateTime.
But if specified, then the closeDateTime must be greater than or equal to the dueDateTime.
The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time.
For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z
[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.For drive items, the display name might not always be available or up to date.
For example, if a user changes their display name the API might show the new value in a future response, but the items associated with the user don't show up as changed when using delta.
[Id <String>]: Unique identifier for the identity or actor.
For example, in the access reviews decisions API, this property might record the id of the principal, that is, the group, user, or application that's subject to review.
[Device <IMicrosoftGraphIdentity>]: identity
[User <IMicrosoftGraphIdentity>]: identity
[DisplayName <String>]: Name of the assignment.
[DueDateTime <DateTime?>]: Date when the students assignment is due.
The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time.
For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z
[Grading <IMicrosoftGraphEducationAssignmentGradeType>]: educationAssignmentGradeType
[(Any) <Object>]: This indicates any property can be added to this object.
[GradingCategory <IMicrosoftGraphEducationGradingCategory>]: educationGradingCategory
[(Any) <Object>]: This indicates any property can be added to this object.
[Id <String>]: The unique identifier for an entity.
Read-only.
[DisplayName <String>]: The name of the grading category.
[PercentageWeight <Int32?>]: The weight of the category; an integer between 0 and 100.
[Instructions <IMicrosoftGraphEducationItemBody>]: educationItemBody
[(Any) <Object>]: This indicates any property can be added to this object.
[Content <String>]:
[ContentType <String>]: bodyType
[LastModifiedBy <IMicrosoftGraphIdentitySet>]: identitySet
[ModuleUrl <String>]: The URL of the module from which to access the assignment.
[NotificationChannelUrl <String>]: Optional field to specify the URL of the channel to post the assignment publish notification.
If not specified or null, defaults to the General channel.
This field only applies to assignments where the assignTo value is educationAssignmentClassRecipient.
Updating the notificationChannelUrl isn't allowed after the assignment is published.
[Resources <IMicrosoftGraphEducationAssignmentResource[]>]: Learning objects that are associated with this assignment.
Only teachers can modify this list.
Nullable.
[Id <String>]: The unique identifier for an entity.
Read-only.
[DistributeForStudentWork <Boolean?>]: Indicates whether this resource should be copied to each student submission for modification and submission.
Required
[Resource <IMicrosoftGraphEducationResource>]: educationResource
[(Any) <Object>]: This indicates any property can be added to this object.
[CreatedBy <IMicrosoftGraphIdentitySet>]: identitySet
[DisplayName <String>]: Display name of resource.
[LastModifiedBy <IMicrosoftGraphIdentitySet>]: identitySet
[Rubric <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
[Description <IMicrosoftGraphEducationItemBody>]: educationItemBody
[DisplayName <String>]: The name of this rubric.
[Grading <IMicrosoftGraphEducationAssignmentGradeType>]: educationAssignmentGradeType
[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.
[Status <String>]: educationAssignmentStatus
[Submissions <IMicrosoftGraphEducationSubmission[]>]: Once published, there's a submission object for each student representing their work and grade.
Read-only.
Nullable.
[Id <String>]: The unique identifier for an entity.
Read-only.
[ExcusedBy <IMicrosoftGraphIdentitySet>]: identitySet
[LastModifiedBy <IMicrosoftGraphIdentitySet>]: identitySet
[Outcomes <IMicrosoftGraphEducationOutcome[]>]:
[Id <String>]: The unique identifier for an entity.
Read-only.
[LastModifiedBy <IMicrosoftGraphIdentitySet>]: identitySet
[LastModifiedDateTime <DateTime?>]: The moment in time when the resource was last modified.
The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time.
For example, midnight UTC on Jan 1, 2021 is 2021-01-01T00:00:00Z.
[ReassignedBy <IMicrosoftGraphIdentitySet>]: identitySet
[Recipient <IMicrosoftGraphEducationSubmissionRecipient>]: educationSubmissionRecipient
[(Any) <Object>]: This indicates any property can be added to this object.
[Resources <IMicrosoftGraphEducationSubmissionResource[]>]:
[Id <String>]: The unique identifier for an entity.
Read-only.
[AssignmentResourceUrl <String>]: Pointer to the assignment from which the resource was copied, and if null, the student uploaded the resource.
[Resource <IMicrosoftGraphEducationResource>]: educationResource
[ReturnedBy <IMicrosoftGraphIdentitySet>]: identitySet
[Status <String>]: educationSubmissionStatus
[SubmittedBy <IMicrosoftGraphIdentitySet>]: identitySet
[SubmittedResources <IMicrosoftGraphEducationSubmissionResource[]>]:
[UnsubmittedBy <IMicrosoftGraphIdentitySet>]: identitySet
CATEGORIES <IMicrosoftGraphEducationCategory[]>: When set, enables users to easily find assignments of a given type.
Read-only.
Nullable.
[Id <String>]: The unique identifier for an entity.
Read-only.
[DisplayName <String>]: Unique identifier for the category.
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.For drive items, the display name might not always be available or up to date.
For example, if a user changes their display name the API might show the new value in a future response, but the items associated with the user don't show up as changed when using delta.
[Id <String>]: Unique identifier for the identity or actor.
For example, in the access reviews decisions API, this property might record the id of the principal, that is, the group, user, or application that's subject to review.
[Device <IMicrosoftGraphIdentity>]: identity
[User <IMicrosoftGraphIdentity>]: identity
GRADINGCATEGORY <IMicrosoftGraphEducationGradingCategory>: educationGradingCategory
[(Any) <Object>]: This indicates any property can be added to this object.
[Id <String>]: The unique identifier for an entity.
Read-only.
[DisplayName <String>]: The name of the grading category.
[PercentageWeight <Int32?>]: The weight of the category; an integer between 0 and 100.
INPUTOBJECT <IEducationIdentity>: Identity Parameter
[EducationAssignmentId <String>]: The unique identifier of educationAssignment
[EducationAssignmentResourceId <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
[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
[EducationUserId <String>]: The unique identifier of educationUser
[ReadingAssignmentSubmissionId <String>]: The unique identifier of readingAssignmentSubmission
[ReflectCheckInResponseId <String>]: The unique identifier of reflectCheckInResponse
INSTRUCTIONS <IMicrosoftGraphEducationItemBody>: educationItemBody
[(Any) <Object>]: This indicates any property can be added to this object.
[Content <String>]:
[ContentType <String>]: bodyType
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.For drive items, the display name might not always be available or up to date.
For example, if a user changes their display name the API might show the new value in a future response, but the items associated with the user don't show up as changed when using delta.
[Id <String>]: Unique identifier for the identity or actor.
For example, in the access reviews decisions API, this property might record the id of the principal, that is, the group, user, or application that's subject to review.
[Device <IMicrosoftGraphIdentity>]: identity
[User <IMicrosoftGraphIdentity>]: identity
RESOURCES <IMicrosoftGraphEducationAssignmentResource[]>: Learning objects that are associated with this assignment.
Only teachers can modify this list.
Nullable.
[Id <String>]: The unique identifier for an entity.
Read-only.
[DistributeForStudentWork <Boolean?>]: Indicates whether this resource should be copied to each student submission for modification and submission.
Required
[Resource <IMicrosoftGraphEducationResource>]: educationResource
[(Any) <Object>]: This indicates any property can be added to this object.
[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.For drive items, the display name might not always be available or up to date.
For example, if a user changes their display name the API might show the new value in a future response, but the items associated with the user don't show up as changed when using delta.
[Id <String>]: Unique identifier for the identity or actor.
For example, in the access reviews decisions API, this property might record the id of the principal, that is, the group, user, or application that's subject to review.
[Device <IMicrosoftGraphIdentity>]: identity
[User <IMicrosoftGraphIdentity>]: identity
[DisplayName <String>]: Display name of resource.
[LastModifiedBy <IMicrosoftGraphIdentitySet>]: identitySet
RUBRIC <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.For drive items, the display name might not always be available or up to date.
For example, if a user changes their display name the API might show the new value in a future response, but the items associated with the user don't show up as changed when using delta.
[Id <String>]: Unique identifier for the identity or actor.
For example, in the access reviews decisions API, this property might record the id of the principal, that is, the group, user, or application that's subject to review.
[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.
SUBMISSIONS <IMicrosoftGraphEducationSubmission[]>: Once published, there's a submission object for each student representing their work and grade.
Read-only.
Nullable.
[Id <String>]: The unique identifier for an entity.
Read-only.
[ExcusedBy <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.For drive items, the display name might not always be available or up to date.
For example, if a user changes their display name the API might show the new value in a future response, but the items associated with the user don't show up as changed when using delta.
[Id <String>]: Unique identifier for the identity or actor.
For example, in the access reviews decisions API, this property might record the id of the principal, that is, the group, user, or application that's subject to review.
[Device <IMicrosoftGraphIdentity>]: identity
[User <IMicrosoftGraphIdentity>]: identity
[LastModifiedBy <IMicrosoftGraphIdentitySet>]: identitySet
[Outcomes <IMicrosoftGraphEducationOutcome[]>]:
[Id <String>]: The unique identifier for an entity.
Read-only.
[LastModifiedBy <IMicrosoftGraphIdentitySet>]: identitySet
[LastModifiedDateTime <DateTime?>]: The moment in time when the resource was last modified.
The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time.
For example, midnight UTC on Jan 1, 2021 is 2021-01-01T00:00:00Z.
[ReassignedBy <IMicrosoftGraphIdentitySet>]: identitySet
[Recipient <IMicrosoftGraphEducationSubmissionRecipient>]: educationSubmissionRecipient
[(Any) <Object>]: This indicates any property can be added to this object.
[Resources <IMicrosoftGraphEducationSubmissionResource[]>]:
[Id <String>]: The unique identifier for an entity.
Read-only.
[AssignmentResourceUrl <String>]: Pointer to the assignment from which the resource was copied, and if null, the student uploaded the resource.
[Resource <IMicrosoftGraphEducationResource>]: educationResource
[(Any) <Object>]: This indicates any property can be added to this object.
[CreatedBy <IMicrosoftGraphIdentitySet>]: identitySet
[DisplayName <String>]: Display name of resource.
[LastModifiedBy <IMicrosoftGraphIdentitySet>]: identitySet
[ReturnedBy <IMicrosoftGraphIdentitySet>]: identitySet
[Status <String>]: educationSubmissionStatus
[SubmittedBy <IMicrosoftGraphIdentitySet>]: identitySet
[SubmittedResources <IMicrosoftGraphEducationSubmissionResource[]>]:
[UnsubmittedBy <IMicrosoftGraphIdentitySet>]: identitySet