Share via

New-MgBetaDeviceManagementWindowsFeatureUpdateProfile

  • Reference
Module:
Microsoft.Graph.Beta.DeviceManagement.Enrollment

Create new navigation property to windowsFeatureUpdateProfiles for deviceManagement

Syntax

New-MgBetaDeviceManagementWindowsFeatureUpdateProfile
   [-ResponseHeadersVariable <String>]
   [-AdditionalProperties <Hashtable>]
   [-Assignments <IMicrosoftGraphWindowsFeatureUpdateProfileAssignment[]>]
   [-CreatedDateTime <DateTime>]
   [-DeployableContentDisplayName <String>]
   [-Description <String>]
   [-DisplayName <String>]
   [-EndOfSupportDate <DateTime>]
   [-FeatureUpdateVersion <String>]
   [-Id <String>]
   [-InstallFeatureUpdatesOptional]
   [-InstallLatestWindows10OnWindows11IneligibleDevice]
   [-LastModifiedDateTime <DateTime>]
   [-RoleScopeTagIds <String[]>]
   [-RolloutSettings <IMicrosoftGraphWindowsUpdateRolloutSettings>]
   [-Headers <IDictionary>]
   [-ProgressAction <ActionPreference>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-MgBetaDeviceManagementWindowsFeatureUpdateProfile
   -BodyParameter <IMicrosoftGraphWindowsFeatureUpdateProfile>
   [-ResponseHeadersVariable <String>]
   [-Headers <IDictionary>]
   [-ProgressAction <ActionPreference>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Create new navigation property to windowsFeatureUpdateProfiles for deviceManagement

Parameters

-AdditionalProperties

Additional Parameters

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

-Assignments

The list of group assignments of the profile. To construct, see NOTES section for ASSIGNMENTS properties and create a hash table.

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

-BodyParameter

Windows Feature Update Profile To construct, see NOTES section for BODYPARAMETER properties and create a hash table.

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

-CreatedDateTime

The date time that the profile was created.

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

-DeployableContentDisplayName

Friendly display name of the quality update profile deployable content

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

-Description

The description of the profile which is specified by the user.

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

-DisplayName

The display name of the profile.

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

-EndOfSupportDate

The last supported date for a feature update

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

-FeatureUpdateVersion

The feature update version that will be deployed to the devices targeted by this profile. The version could be any supported version for example 1709, 1803 or 1809 and so on.

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

-InstallFeatureUpdatesOptional

If true, the Windows 11 update will become optional

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

-InstallLatestWindows10OnWindows11IneligibleDevice

If true, the latest Microsoft Windows 10 update will be installed on devices ineligible for Microsoft Windows 11

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

-LastModifiedDateTime

The date time that the profile was last modified.

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

-RoleScopeTagIds

List of Scope Tags for this Feature Update entity.

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

-RolloutSettings

A complex type to store the windows update rollout settings including offer start date time, offer end date time, and days between each set of offers. To construct, see NOTES section for ROLLOUTSETTINGS properties and create a hash table.

Type:IMicrosoftGraphWindowsUpdateRolloutSettings
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.IMicrosoftGraphWindowsFeatureUpdateProfile

System.Collections.IDictionary

Outputs

Microsoft.Graph.Beta.PowerShell.Models.IMicrosoftGraphWindowsFeatureUpdateProfile

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.

ASSIGNMENTS <IMicrosoftGraphWindowsFeatureUpdateProfileAssignment- []>: The list of group assignments of the profile.

  • [Id <String>]: The unique identifier for an entity. Read-only.
  • [Target <IMicrosoftGraphDeviceAndAppManagementAssignmentTarget>]: Base type for assignment targets.
    • [(Any) <Object>]: This indicates any property can be added to this object.
    • [DeviceAndAppManagementAssignmentFilterId <String>]: The Id of the filter for the target assignment.
    • [DeviceAndAppManagementAssignmentFilterType <DeviceAndAppManagementAssignmentFilterType?>]: Represents type of the assignment filter.

BODYPARAMETER <IMicrosoftGraphWindowsFeatureUpdateProfile>: Windows Feature Update Profile

  • [(Any) <Object>]: This indicates any property can be added to this object.
  • [Id <String>]: The unique identifier for an entity. Read-only.
  • [Assignments <IMicrosoftGraphWindowsFeatureUpdateProfileAssignment- []>]: The list of group assignments of the profile.
    • [Id <String>]: The unique identifier for an entity. Read-only.
    • [Target <IMicrosoftGraphDeviceAndAppManagementAssignmentTarget>]: Base type for assignment targets.
      • [(Any) <Object>]: This indicates any property can be added to this object.
      • [DeviceAndAppManagementAssignmentFilterId <String>]: The Id of the filter for the target assignment.
      • [DeviceAndAppManagementAssignmentFilterType <DeviceAndAppManagementAssignmentFilterType?>]: Represents type of the assignment filter.
  • [CreatedDateTime <DateTime?>]: The date time that the profile was created.
  • [DeployableContentDisplayName <String>]: Friendly display name of the quality update profile deployable content
  • [Description <String>]: The description of the profile which is specified by the user.
  • [DisplayName <String>]: The display name of the profile.
  • [EndOfSupportDate <DateTime?>]: The last supported date for a feature update
  • [FeatureUpdateVersion <String>]: The feature update version that will be deployed to the devices targeted by this profile. The version could be any supported version for example 1709, 1803 or 1809 and so on.
  • [InstallFeatureUpdatesOptional <Boolean?>]: If true, the Windows 11 update will become optional
  • [InstallLatestWindows10OnWindows11IneligibleDevice <Boolean?>]: If true, the latest Microsoft Windows 10 update will be installed on devices ineligible for Microsoft Windows 11
  • [LastModifiedDateTime <DateTime?>]: The date time that the profile was last modified.
  • [RoleScopeTagIds <String- []>]: List of Scope Tags for this Feature Update entity.
  • [RolloutSettings <IMicrosoftGraphWindowsUpdateRolloutSettings>]: A complex type to store the windows update rollout settings including offer start date time, offer end date time, and days between each set of offers.
    • [(Any) <Object>]: This indicates any property can be added to this object.
    • [OfferEndDateTimeInUtc <DateTime?>]: The feature update's ending of release date and time to be set, update, and displayed for a feature Update profile for example: 2020-06-09T10:00:00Z.
    • [OfferIntervalInDays <Int32?>]: The number of day(s) between each set of offers to be set, updated, and displayed for a feature update profile, for example: if OfferStartDateTimeInUTC is 2020-06-09T10:00:00Z, and OfferIntervalInDays is 1, then the next two sets of offers will be made consecutively on 2020-06-10T10:00:00Z (next day at the same specified time) and 2020-06-11T10:00:00Z (next next day at the same specified time) with 1 day in between each set of offers.
    • [OfferStartDateTimeInUtc <DateTime?>]: The feature update's starting date and time to be set, update, and displayed for a feature Update profile for example: 2020-06-09T10:00:00Z.

ROLLOUTSETTINGS <IMicrosoftGraphWindowsUpdateRolloutSettings>: A complex type to store the windows update rollout settings including offer start date time, offer end date time, and days between each set of offers.

  • [(Any) <Object>]: This indicates any property can be added to this object.
  • [OfferEndDateTimeInUtc <DateTime?>]: The feature update's ending of release date and time to be set, update, and displayed for a feature Update profile for example: 2020-06-09T10:00:00Z.
  • [OfferIntervalInDays <Int32?>]: The number of day(s) between each set of offers to be set, updated, and displayed for a feature update profile, for example: if OfferStartDateTimeInUTC is 2020-06-09T10:00:00Z, and OfferIntervalInDays is 1, then the next two sets of offers will be made consecutively on 2020-06-10T10:00:00Z (next day at the same specified time) and 2020-06-11T10:00:00Z (next next day at the same specified time) with 1 day in between each set of offers.
  • [OfferStartDateTimeInUtc <DateTime?>]: The feature update's starting date and time to be set, update, and displayed for a feature Update profile for example: 2020-06-09T10:00:00Z.