Share via

New-MgBetaExternalIndustryDataYear

  • Reference
Module:
Microsoft.Graph.Beta.Search

Create a new yearTimePeriodDefinition object.

Syntax

New-MgBetaExternalIndustryDataYear
   [-ResponseHeadersVariable <String>]
   [-AdditionalProperties <Hashtable>]
   [-DisplayName <String>]
   [-EndDate <DateTime>]
   [-Id <String>]
   [-StartDate <DateTime>]
   [-Year <Hashtable>]
   [-Headers <IDictionary>]
   [-ProgressAction <ActionPreference>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-MgBetaExternalIndustryDataYear
   -BodyParameter <IMicrosoftGraphIndustryDataYearTimePeriodDefinition>
   [-ResponseHeadersVariable <String>]
   [-Headers <IDictionary>]
   [-ProgressAction <ActionPreference>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Create a new yearTimePeriodDefinition object.

Permissions

Permission type Least privileged permissions Higher privileged permissions
Delegated (work or school account) IndustryData-TimePeriod.ReadWrite.All Not available.
Delegated (personal Microsoft account) Not supported. Not supported.
Application IndustryData-TimePeriod.ReadWrite.All Not available.

Examples

Example 1: Code snippet

Import-Module Microsoft.Graph.Beta.Search

$params = @{
	displayName = "Fiscal Year 2022"
	endDate = "2023-06-15"
	startDate = "2022-09-01"
	year = @{
		code = "2022"
	}
}

New-MgBetaExternalIndustryDataYear -BodyParameter $params

This example shows how to use the New-MgBetaExternalIndustryDataYear Cmdlet.

Parameters

-AdditionalProperties

Additional Parameters

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

-BodyParameter

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

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

-DisplayName

The name of the year. Maximum supported length is 100 characters.

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

-EndDate

The last day of the year using ISO 8601 format for date.

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

-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

-StartDate

The first day of the year using ISO 8601 format for date.

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

-Year

yearReferenceValue

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

Inputs

Microsoft.Graph.Beta.PowerShell.Models.IMicrosoftGraphIndustryDataYearTimePeriodDefinition

System.Collections.IDictionary

Outputs

Microsoft.Graph.Beta.PowerShell.Models.IMicrosoftGraphIndustryDataYearTimePeriodDefinition

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 <IMicrosoftGraphIndustryDataYearTimePeriodDefinition>: yearTimePeriodDefinition

  • [(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 year. Maximum supported length is 100 characters.
  • [EndDate <DateTime?>]: The last day of the year using ISO 8601 format for date.
  • [StartDate <DateTime?>]: The first day of the year using ISO 8601 format for date.
  • [Year <IMicrosoftGraphIndustryDataYearReferenceValue>]: yearReferenceValue
    • [(Any) <Object>]: This indicates any property can be added to this object.
    • [Code <String>]: The code of the desired referenceDefinition entry.
    • [Value <IMicrosoftGraphIndustryDataReferenceDefinition>]: referenceDefinition
      • [(Any) <Object>]: This indicates any property can be added to this object.
      • [Id <String>]: The unique identifier for an entity. Read-only.
      • [Code <String>]: The code value for the definition that must be unique within the referenceType.
      • [DisplayName <String>]: A human-readable representation of the reference code value for display in a user interface.
      • [IsDisabled <Boolean?>]: Indicates whether the definition is disabled.
      • [ReferenceType <String>]: The categorical type for a collection of enumerated values.
      • [SortIndex <Int32?>]: The index that specifies the order in which to present the definition to the user. Must be unique within the referenceType.