Skip to content

New GClassroomCourseObj

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

New-GClassroomCourseObj

SYNOPSIS

Creates a new Classroom API Course object.

SYNTAX

New-GClassroomCourseObj [[-AlternateLink] <String>] [[-CourseGroupEmail] <String>]
 [[-CourseMaterialSets] <CourseMaterialSet[]>] [[-CourseState] <String>] [[-CreationTime] <String>]
 [[-Description] <String>] [[-DescriptionHeading] <String>] [[-EnrollmentCode] <String>]
 [[-GuardiansEnabled] <Boolean>] [[-Id] <String>] [[-Name] <String>] [[-OwnerId] <String>] [[-Room] <String>]
 [[-Section] <String>] [[-TeacherFolder] <DriveFolder>] [[-TeacherGroupEmail] <String>]
 [[-UpdateTime] <String>] [-WhatIf] [-Confirm]

DESCRIPTION

This provides a Cmdlet-Based approach to creating a Course object which may be required as a parameter for some other Cmdlets in the Classroom API category.

You could alternately create this object by calling New-Object -TypeName Google.Apis.Classroom.v1.Data.Course

EXAMPLES

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

PS C:\> New-GClassroomCourseObj

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

-AlternateLink

Absolute link to this course in the Classroom web UI. Read-only.

Type: String
Parameter Sets: (All)
Aliases: 

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

-CourseGroupEmail

The email address of a Google group containing all members of the course. This group does not accept email and can only be used for permissions. Read-only.

Type: String
Parameter Sets: (All)
Aliases: 

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

-CourseMaterialSets

Sets of materials that appear on the "about" page of this course. Read-only.

Type: CourseMaterialSet[]
Parameter Sets: (All)
Aliases: 

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

-CourseState

State of the course. If unspecified, the default state is `PROVISIONED`.

Type: String
Parameter Sets: (All)
Aliases: 

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

-CreationTime

Creation time of the course. Specifying this field in a course update mask results in an error. Read-only.

Type: String
Parameter Sets: (All)
Aliases: 

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

-Description

Optional description. For example, "We'll be learning about the structure of living creatures from a combination of textbooks, guest lectures, and lab work. Expect to be excited!" If set, this field must be a valid UTF-8 string and no longer than 30,000 characters.

Type: String
Parameter Sets: (All)
Aliases: 

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

-DescriptionHeading

Optional heading for the description. For example, "Welcome to 10th Grade Biology." If set, this field must be a valid UTF-8 string and no longer than 3600 characters.

Type: String
Parameter Sets: (All)
Aliases: 

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

-EnrollmentCode

Enrollment code to use when joining this course. Specifying this field in a course update mask results in an error. Read-only.

Type: String
Parameter Sets: (All)
Aliases: 

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

-GuardiansEnabled

Whether or not guardian notifications are enabled for this course. Read-only.

Type: Boolean
Parameter Sets: (All)
Aliases: 

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

-Id

Identifier for this course assigned by Classroom. When creating a course, you may optionally set this identifier to an alias string in the request to create a corresponding alias. The `id` is still assigned by Classroom and cannot be updated after the course is created. Specifying this field in a course update mask results in an error.

Type: String
Parameter Sets: (All)
Aliases: 

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

-Name

Name of the course. For example, "10th Grade Biology". The name is required. It must be between 1 and 750 characters and a valid UTF-8 string.

Type: String
Parameter Sets: (All)
Aliases: 

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

-OwnerId

The identifier of the owner of a course. When specified as a parameter of a create course request, this field is required. The identifier can be one of the following: * the numeric identifier for the user * the email address of the user * the string literal `"me"`, indicating the requesting user This must be set in a create request. Specifying this field in a course update mask results in an `INVALID_ARGUMENT` error.

Type: String
Parameter Sets: (All)
Aliases: 

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

-Room

Optional room location. For example, "301". If set, this field must be a valid UTF-8 string and no longer than 650 characters.

Type: String
Parameter Sets: (All)
Aliases: 

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

-Section

Section of the course. For example, "Period 2". If set, this field must be a valid UTF-8 string and no longer than 2800 characters.

Type: String
Parameter Sets: (All)
Aliases: 

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

-TeacherFolder

Information about a Drive Folder that is shared with all teachers of the course. This field will only be set for teachers of the course and domain administrators. Read-only.

Type: DriveFolder
Parameter Sets: (All)
Aliases: 

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

-TeacherGroupEmail

The email address of a Google group containing all teachers of the course. This group does not accept email and can only be used for permissions. Read-only.

Type: String
Parameter Sets: (All)
Aliases: 

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

-UpdateTime

Time of the most recent update to this course. Specifying this field in a course update mask results in an error. Read-only.

Type: String
Parameter Sets: (All)
Aliases: 

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

INPUTS

System.String

Absolute link to this course in the Classroom web UI. Read-only.

System.String

The email address of a Google group containing all members of the course. This group does not accept email and can only be used for permissions. Read-only.

Google.Apis.Classroom.v1.Data.CourseMaterialSet[]

Sets of materials that appear on the "about" page of this course. Read-only.

System.String

State of the course. If unspecified, the default state is `PROVISIONED`.

System.String

Creation time of the course. Specifying this field in a course update mask results in an error. Read-only.

System.String

Optional description. For example, "We'll be learning about the structure of living creatures from a combination of textbooks, guest lectures, and lab work. Expect to be excited!" If set, this field must be a valid UTF-8 string and no longer than 30,000 characters.

System.String

Optional heading for the description. For example, "Welcome to 10th Grade Biology." If set, this field must be a valid UTF-8 string and no longer than 3600 characters.

System.String

Enrollment code to use when joining this course. Specifying this field in a course update mask results in an error. Read-only.

System.Boolean

Whether or not guardian notifications are enabled for this course. Read-only.

System.String

Identifier for this course assigned by Classroom. When creating a course, you may optionally set this identifier to an alias string in the request to create a corresponding alias. The `id` is still assigned by Classroom and cannot be updated after the course is created. Specifying this field in a course update mask results in an error.

System.String

Name of the course. For example, "10th Grade Biology". The name is required. It must be between 1 and 750 characters and a valid UTF-8 string.

System.String

The identifier of the owner of a course. When specified as a parameter of a create course request, this field is required. The identifier can be one of the following: * the numeric identifier for the user * the email address of the user * the string literal `"me"`, indicating the requesting user This must be set in a create request. Specifying this field in a course update mask results in an `INVALID_ARGUMENT` error.

System.String

Optional room location. For example, "301". If set, this field must be a valid UTF-8 string and no longer than 650 characters.

System.String

Section of the course. For example, "Period 2". If set, this field must be a valid UTF-8 string and no longer than 2800 characters.

Google.Apis.Classroom.v1.Data.DriveFolder

Information about a Drive Folder that is shared with all teachers of the course. This field will only be set for teachers of the course and domain administrators. Read-only.

System.String

The email address of a Google group containing all teachers of the course. This group does not accept email and can only be used for permissions. Read-only.

System.String

Time of the most recent update to this course. Specifying this field in a course update mask results in an error. Read-only.

OUTPUTS

Google.Apis.Classroom.v1.Data.Course

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