Skip to content

Set GClassroomCourse

Spencer Varney edited this page Dec 27, 2016 · 3 revisions

Set-GClassroomCourse

SYNOPSIS

Updates one or more fields in a course. This method returns the following error codes: * `PERMISSION_DENIED` if the requesting user is not permitted to modify the requested course or for access errors.

  • `NOT_FOUND` if no course exists with the requested ID.
  • `INVALID_ARGUMENT` if invalid fields are specified in the update mask or if no update mask is supplied.
  • `FAILED_PRECONDITION` for the following request errors: * CourseNotModifiable

SYNTAX

Set-GClassroomCourse [-Id] <String> [[-CourseBody] <Course>] [[-UpdateMask] <String>]
 [-StandardQueryParams <StandardQueryParameters>] [-GAuthId <String>] [-WhatIf] [-Confirm]

DESCRIPTION

Updates one or more fields in a course. This method returns the following error codes: * `PERMISSION_DENIED` if the requesting user is not permitted to modify the requested course or for access errors.

  • `NOT_FOUND` if no course exists with the requested ID.
  • `INVALID_ARGUMENT` if invalid fields are specified in the update mask or if no update mask is supplied.
  • `FAILED_PRECONDITION` for the following request errors: * CourseNotModifiable

EXAMPLES

---------- EXAMPLE 1 ----------

PS C:\> Set-GClassroomCourse -Id $SomeIdString -CourseBody $SomeCourseObj

This automatically generated example serves to show the bare minimum required to call this Cmdlet.

Additional examples may be added, viewed and edited by users on the community wiki at the URL found in the related links.

PARAMETERS

-Id

Identifier of the course to update. This identifier can be either the Classroom-assigned identifier or an alias.

Type: String
Parameter Sets: (All)
Aliases: 

Required: True
Position: 0
Default value: 
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-CourseBody

A Course in Classroom.

Type: Course
Parameter Sets: (All)
Aliases: 

Required: False
Position: 1
Default value: 
Accept pipeline input: True (ByPropertyName, ByValue)
Accept wildcard characters: False

-UpdateMask

Mask that identifies which fields on the course to update. This field is required to do an update. The update will fail if invalid fields are specified. The following fields are valid: * `name` * `section` * `descriptionHeading` * `description` * `room` * `courseState` When set in a query parameter, this field should be specified as `updateMask=,,...`

Type: String
Parameter Sets: (All)
Aliases: 

Required: False
Position: 2
Default value: 
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-StandardQueryParams

A Standard Query Parameters Object.

Type: StandardQueryParameters
Parameter Sets: (All)
Aliases: 

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

-GAuthId

The GAuthId representing the gShell auth credentials this cmdlet should use to run.

Type: String
Parameter Sets: (All)
Aliases: 

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

INPUTS

System.String

Identifier of the course to update. This identifier can be either the Classroom-assigned identifier or an alias.

Google.Apis.Classroom.v1.Data.Course

A Course in Classroom.

System.String

Mask that identifies which fields on the course to update. This field is required to do an update. The update will fail if invalid fields are specified. The following fields are valid: * `name` * `section` * `descriptionHeading` * `description` * `room` * `courseState` When set in a query parameter, this field should be specified as `updateMask=,,...`

OUTPUTS

NOTES

Part of the gShell Project, relating to the Google Classroom API; see Related Links or use the -Online parameter.

RELATED LINKS

[Wiki page for this Cmdlet]

[Getting started with gShell]

Clone this wiki locally