New-MgBetaTeamScheduleTimeCard

Create a timeCard instance in a schedule.

Syntax

New-MgBetaTeamScheduleTimeCard
   -TeamId <String>
   [-ResponseHeadersVariable <String>]
   [-AdditionalProperties <Hashtable>]
   [-Breaks <IMicrosoftGraphTimeCardBreak[]>]
   [-ClockInEvent <IMicrosoftGraphTimeCardEvent>]
   [-ClockOutEvent <IMicrosoftGraphTimeCardEvent>]
   [-ConfirmedBy <String>]
   [-CreatedBy <IMicrosoftGraphIdentitySet>]
   [-Id <String>]
   [-LastModifiedBy <IMicrosoftGraphIdentitySet>]
   [-Notes <IMicrosoftGraphItemBody>]
   [-OriginalEntry <IMicrosoftGraphTimeCardEntry>]
   [-State <String>]
   [-UserId <String>]
   [-Headers <IDictionary>]
   [-ProgressAction <ActionPreference>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-MgBetaTeamScheduleTimeCard
   -TeamId <String>
   -BodyParameter <IMicrosoftGraphTimeCard>
   [-ResponseHeadersVariable <String>]
   [-Headers <IDictionary>]
   [-ProgressAction <ActionPreference>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-MgBetaTeamScheduleTimeCard
   -InputObject <ITeamsIdentity>
   [-ResponseHeadersVariable <String>]
   [-AdditionalProperties <Hashtable>]
   [-Breaks <IMicrosoftGraphTimeCardBreak[]>]
   [-ClockInEvent <IMicrosoftGraphTimeCardEvent>]
   [-ClockOutEvent <IMicrosoftGraphTimeCardEvent>]
   [-ConfirmedBy <String>]
   [-CreatedBy <IMicrosoftGraphIdentitySet>]
   [-Id <String>]
   [-LastModifiedBy <IMicrosoftGraphIdentitySet>]
   [-Notes <IMicrosoftGraphItemBody>]
   [-OriginalEntry <IMicrosoftGraphTimeCardEntry>]
   [-State <String>]
   [-UserId <String>]
   [-Headers <IDictionary>]
   [-ProgressAction <ActionPreference>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-MgBetaTeamScheduleTimeCard
   -InputObject <ITeamsIdentity>
   -BodyParameter <IMicrosoftGraphTimeCard>
   [-ResponseHeadersVariable <String>]
   [-Headers <IDictionary>]
   [-ProgressAction <ActionPreference>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Create a timeCard instance in a schedule.

Examples

Example 1: Using the New-MgBetaTeamScheduleTimeCard Cmdlet

Import-Module Microsoft.Graph.Beta.Teams
$params = @{
	OnBehalfOfUserId = "a3601044-a1b5-438e-b742-f78d01d68a67"
	ClockInEvent = @{
		DateTime = [System.DateTime]::Parse("2019-03-18T00:00:00.000Z")
		AtApprovedLocation = $true
		Notes = @{
			Content = "Started late due to traffic in CA 237"
			ContentType = "text"
		}
	}
	Notes = @{
		Content = "8 To 5 Inventory management"
		ContentType = "text"
	}
	Breaks = @(
		@{
			BreakId = "string"
			Notes = @{
				Content = "Lunch break"
				ContentType = "text"
			}
			Start = @{
				DateTime = [System.DateTime]::Parse("2019-03-18T02:00:00.000Z")
				AtApprovedLocation = $true
				Notes = @{
					Content = "Reduced break to make up for lost time"
					ContentType = "text"
				}
			}
		}
	)
}
New-MgBetaTeamScheduleTimeCard -TeamId $teamId -BodyParameter $params

This example shows how to use the New-MgBetaTeamScheduleTimeCard Cmdlet. To learn about permissions for this resource, see the permissions reference.

Parameters

-AdditionalProperties

Additional Parameters

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

-BodyParameter

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

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

-Breaks

The list of breaks associated with the timeCard. To construct, see NOTES section for BREAKS properties and create a hash table.

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

-ClockInEvent

timeCardEvent To construct, see NOTES section for CLOCKINEVENT properties and create a hash table.

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

-ClockOutEvent

timeCardEvent To construct, see NOTES section for CLOCKOUTEVENT properties and create a hash table.

Type:IMicrosoftGraphTimeCardEvent
Position:Named
Default value:None
Required:False
Accept pipeline input:False
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

-ConfirmedBy

confirmedBy

Type:String
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

-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:ITeamsIdentity
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

-Notes

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

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

-OriginalEntry

timeCardEntry To construct, see NOTES section for ORIGINALENTRY properties and create a hash table.

Type:IMicrosoftGraphTimeCardEntry
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

-ResponseHeadersVariable

Optional Response Headers Variable.

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

-State

timeCardState

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

-TeamId

The unique identifier of team

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

-UserId

User ID to which the timeCard belongs.

Type:String
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.IMicrosoftGraphTimeCard

Microsoft.Graph.Beta.PowerShell.Models.ITeamsIdentity

System.Collections.IDictionary

Outputs

Microsoft.Graph.Beta.PowerShell.Models.IMicrosoftGraphTimeCard

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 <IMicrosoftGraphTimeCard>: timeCard

  • [(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. 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 won't show up as having changed when using delta.
      • [Id <String>]: Unique identifier for the identity. When the unique identifier is unavailable, the displayName property is provided for the identity, but the id property isn't included in the response.
    • [Device <IMicrosoftGraphIdentity>]: identity
    • [User <IMicrosoftGraphIdentity>]: identity
  • [LastModifiedBy <IMicrosoftGraphIdentitySet>]: identitySet
  • [Id <String>]: The unique identifier for an entity. Read-only.
  • [Breaks <IMicrosoftGraphTimeCardBreak- []>]: The list of breaks associated with the timeCard.
    • [BreakId <String>]: ID of the timeCardBreak.
    • [End <IMicrosoftGraphTimeCardEvent>]: timeCardEvent
      • [(Any) <Object>]: This indicates any property can be added to this object.
      • [AtApprovedLocation <Boolean?>]: Indicates whether the entry was recorded at the approved location.
      • [DateTime <DateTime?>]: The time the entry is recorded.
      • [Notes <IMicrosoftGraphItemBody>]: itemBody
        • [(Any) <Object>]: This indicates any property can be added to this object.
        • [Content <String>]: The content of the item.
        • [ContentType <String>]: bodyType
    • [Notes <IMicrosoftGraphItemBody>]: itemBody
    • [Start <IMicrosoftGraphTimeCardEvent>]: timeCardEvent
  • [ClockInEvent <IMicrosoftGraphTimeCardEvent>]: timeCardEvent
  • [ClockOutEvent <IMicrosoftGraphTimeCardEvent>]: timeCardEvent
  • [ConfirmedBy <String>]: confirmedBy
  • [Notes <IMicrosoftGraphItemBody>]: itemBody
  • [OriginalEntry <IMicrosoftGraphTimeCardEntry>]: timeCardEntry
    • [(Any) <Object>]: This indicates any property can be added to this object.
    • [Breaks <IMicrosoftGraphTimeCardBreak- []>]: The list of breaks associated with the timeCard.
    • [ClockInEvent <IMicrosoftGraphTimeCardEvent>]: timeCardEvent
    • [ClockOutEvent <IMicrosoftGraphTimeCardEvent>]: timeCardEvent
  • [State <String>]: timeCardState
  • [UserId <String>]: User ID to which the timeCard belongs.

BREAKS <IMicrosoftGraphTimeCardBreak- []>: The list of breaks associated with the timeCard.

  • [BreakId <String>]: ID of the timeCardBreak.
  • [End <IMicrosoftGraphTimeCardEvent>]: timeCardEvent
    • [(Any) <Object>]: This indicates any property can be added to this object.
    • [AtApprovedLocation <Boolean?>]: Indicates whether the entry was recorded at the approved location.
    • [DateTime <DateTime?>]: The time the entry is recorded.
    • [Notes <IMicrosoftGraphItemBody>]: itemBody
      • [(Any) <Object>]: This indicates any property can be added to this object.
      • [Content <String>]: The content of the item.
      • [ContentType <String>]: bodyType
  • [Notes <IMicrosoftGraphItemBody>]: itemBody
  • [Start <IMicrosoftGraphTimeCardEvent>]: timeCardEvent

CLOCKINEVENT <IMicrosoftGraphTimeCardEvent>: timeCardEvent

  • [(Any) <Object>]: This indicates any property can be added to this object.
  • [AtApprovedLocation <Boolean?>]: Indicates whether the entry was recorded at the approved location.
  • [DateTime <DateTime?>]: The time the entry is recorded.
  • [Notes <IMicrosoftGraphItemBody>]: itemBody
    • [(Any) <Object>]: This indicates any property can be added to this object.
    • [Content <String>]: The content of the item.
    • [ContentType <String>]: bodyType

CLOCKOUTEVENT <IMicrosoftGraphTimeCardEvent>: timeCardEvent

  • [(Any) <Object>]: This indicates any property can be added to this object.
  • [AtApprovedLocation <Boolean?>]: Indicates whether the entry was recorded at the approved location.
  • [DateTime <DateTime?>]: The time the entry is recorded.
  • [Notes <IMicrosoftGraphItemBody>]: itemBody
    • [(Any) <Object>]: This indicates any property can be added to this object.
    • [Content <String>]: The content of the item.
    • [ContentType <String>]: bodyType

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. 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 won't show up as having changed when using delta.
    • [Id <String>]: Unique identifier for the identity. When the unique identifier is unavailable, the displayName property is provided for the identity, but the id property isn't included in the response.
  • [Device <IMicrosoftGraphIdentity>]: identity
  • [User <IMicrosoftGraphIdentity>]: identity

INPUTOBJECT <ITeamsIdentity>: Identity Parameter

  • [AssociatedTeamInfoId <String>]: The unique identifier of associatedTeamInfo
  • [ChannelId <String>]: The unique identifier of channel
  • [ChatId <String>]: The unique identifier of chat
  • [ChatMessageHostedContentId <String>]: The unique identifier of chatMessageHostedContent
  • [ChatMessageId <String>]: The unique identifier of chatMessage
  • [ChatMessageId1 <String>]: The unique identifier of chatMessage
  • [ConversationMemberId <String>]: The unique identifier of conversationMember
  • [DayNoteId <String>]: The unique identifier of dayNote
  • [DeletedChatId <String>]: The unique identifier of deletedChat
  • [DeletedTeamId <String>]: The unique identifier of deletedTeam
  • [GroupId <String>]: The unique identifier of group
  • [OfferShiftRequestId <String>]: The unique identifier of offerShiftRequest
  • [OpenShiftChangeRequestId <String>]: The unique identifier of openShiftChangeRequest
  • [OpenShiftId <String>]: The unique identifier of openShift
  • [PinnedChatMessageInfoId <String>]: The unique identifier of pinnedChatMessageInfo
  • [ResourceSpecificPermissionGrantId <String>]: The unique identifier of resourceSpecificPermissionGrant
  • [SchedulingGroupId <String>]: The unique identifier of schedulingGroup
  • [SharedWithChannelTeamInfoId <String>]: The unique identifier of sharedWithChannelTeamInfo
  • [ShiftId <String>]: The unique identifier of shift
  • [ShiftsRoleDefinitionId <String>]: The unique identifier of shiftsRoleDefinition
  • [SwapShiftsChangeRequestId <String>]: The unique identifier of swapShiftsChangeRequest
  • [TeamId <String>]: The unique identifier of team
  • [TeamTemplateDefinitionId <String>]: The unique identifier of teamTemplateDefinition
  • [TeamTemplateId <String>]: The unique identifier of teamTemplate
  • [TeamsAppDashboardCardDefinitionId <String>]: The unique identifier of teamsAppDashboardCardDefinition
  • [TeamsAppDefinitionId <String>]: The unique identifier of teamsAppDefinition
  • [TeamsAppId <String>]: The unique identifier of teamsApp
  • [TeamsAppInstallationId <String>]: The unique identifier of teamsAppInstallation
  • [TeamsAsyncOperationId <String>]: The unique identifier of teamsAsyncOperation
  • [TeamsTabId <String>]: The unique identifier of teamsTab
  • [TeamworkDeviceId <String>]: The unique identifier of teamworkDevice
  • [TeamworkDeviceOperationId <String>]: The unique identifier of teamworkDeviceOperation
  • [TeamworkTagId <String>]: The unique identifier of teamworkTag
  • [TeamworkTagMemberId <String>]: The unique identifier of teamworkTagMember
  • [TimeCardId <String>]: The unique identifier of timeCard
  • [TimeOffId <String>]: The unique identifier of timeOff
  • [TimeOffReasonId <String>]: The unique identifier of timeOffReason
  • [TimeOffRequestId <String>]: The unique identifier of timeOffRequest
  • [UserId <String>]: The unique identifier of user
  • [UserScopeTeamsAppInstallationId <String>]: The unique identifier of userScopeTeamsAppInstallation
  • [WorkforceIntegrationId <String>]: The unique identifier of workforceIntegration

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. 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 won't show up as having changed when using delta.
    • [Id <String>]: Unique identifier for the identity. When the unique identifier is unavailable, the displayName property is provided for the identity, but the id property isn't included in the response.
  • [Device <IMicrosoftGraphIdentity>]: identity
  • [User <IMicrosoftGraphIdentity>]: identity

NOTES <IMicrosoftGraphItemBody>: itemBody

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

ORIGINALENTRY <IMicrosoftGraphTimeCardEntry>: timeCardEntry

  • [(Any) <Object>]: This indicates any property can be added to this object.
  • [Breaks <IMicrosoftGraphTimeCardBreak- []>]: The list of breaks associated with the timeCard.
    • [BreakId <String>]: ID of the timeCardBreak.
    • [End <IMicrosoftGraphTimeCardEvent>]: timeCardEvent
      • [(Any) <Object>]: This indicates any property can be added to this object.
      • [AtApprovedLocation <Boolean?>]: Indicates whether the entry was recorded at the approved location.
      • [DateTime <DateTime?>]: The time the entry is recorded.
      • [Notes <IMicrosoftGraphItemBody>]: itemBody
        • [(Any) <Object>]: This indicates any property can be added to this object.
        • [Content <String>]: The content of the item.
        • [ContentType <String>]: bodyType
    • [Notes <IMicrosoftGraphItemBody>]: itemBody
    • [Start <IMicrosoftGraphTimeCardEvent>]: timeCardEvent
  • [ClockInEvent <IMicrosoftGraphTimeCardEvent>]: timeCardEvent
  • [ClockOutEvent <IMicrosoftGraphTimeCardEvent>]: timeCardEvent

https://learn.microsoft.com/powershell/module/microsoft.graph.beta.teams/new-mgbetateamscheduletimecard

https://learn.microsoft.com/graph/api/timecard-post?view=graph-rest-1.0