New-MgBetaDeviceManagementTermAndCondition

Create new navigation property to termsAndConditions for deviceManagement

Note

To view the v1.0 release of this cmdlet, view New-MgDeviceManagementTermAndCondition

Syntax

New-MgBetaDeviceManagementTermAndCondition
   [-ResponseHeadersVariable <String>]
   [-AcceptanceStatement <String>]
   [-AcceptanceStatuses <IMicrosoftGraphTermsAndConditionsAcceptanceStatus[]>]
   [-AdditionalProperties <Hashtable>]
   [-Assignments <IMicrosoftGraphTermsAndConditionsAssignment[]>]
   [-BodyText <String>]
   [-CreatedDateTime <DateTime>]
   [-Description <String>]
   [-DisplayName <String>]
   [-GroupAssignments <IMicrosoftGraphTermsAndConditionsGroupAssignment[]>]
   [-Id <String>]
   [-LastModifiedDateTime <DateTime>]
   [-ModifiedDateTime <DateTime>]
   [-RoleScopeTagIds <String[]>]
   [-Title <String>]
   [-Version <Int32>]
   [-Headers <IDictionary>]
   [-ProgressAction <ActionPreference>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-MgBetaDeviceManagementTermAndCondition
   -BodyParameter <IMicrosoftGraphTermsAndConditions>
   [-ResponseHeadersVariable <String>]
   [-Headers <IDictionary>]
   [-ProgressAction <ActionPreference>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Create new navigation property to termsAndConditions for deviceManagement

Parameters

-AcceptanceStatement

Administrator-supplied explanation of the terms and conditions, typically describing what it means to accept the terms and conditions set out in the T&C policy. This is shown to the user on prompts to accept the T&C policy.

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

-AcceptanceStatuses

The list of acceptance statuses for this T&C policy. To construct, see NOTES section for ACCEPTANCESTATUSES properties and create a hash table.

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

-AdditionalProperties

Additional Parameters

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

-Assignments

The list of assignments for this T&C policy. To construct, see NOTES section for ASSIGNMENTS properties and create a hash table.

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

-BodyParameter

A termsAndConditions entity represents the metadata and contents of a given Terms and Conditions (T&C) policy. T&C policies' contents are presented to users upon their first attempt to enroll into Intune and subsequently upon edits where an administrator has required re-acceptance. They enable administrators to communicate the provisions to which a user must agree in order to have devices enrolled into Intune. To construct, see NOTES section for BODYPARAMETER properties and create a hash table.

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

-BodyText

Administrator-supplied body text of the terms and conditions, typically the terms themselves. This is shown to the user on prompts to accept the T&C policy.

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

-CreatedDateTime

DateTime the object was created.

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

-Description

Administrator-supplied description of the T&C policy.

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

-DisplayName

Administrator-supplied name for the T&C policy.

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

-GroupAssignments

The list of group assignments for this T&C policy. To construct, see NOTES section for GROUPASSIGNMENTS properties and create a hash table.

Type:IMicrosoftGraphTermsAndConditionsGroupAssignment[]
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

-LastModifiedDateTime

DateTime the object was last modified.

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

-ModifiedDateTime

DateTime the object 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 Entity instance.

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

-Title

Administrator-supplied title of the terms and conditions. This is shown to the user on prompts to accept the T&C policy.

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

-Version

Integer indicating the current version of the terms. Incremented when an administrator makes a change to the terms and wishes to require users to re-accept the modified T&C policy.

Type:Int32
Position:Named
Default value:0
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.IMicrosoftGraphTermsAndConditions

System.Collections.IDictionary

Outputs

Microsoft.Graph.Beta.PowerShell.Models.IMicrosoftGraphTermsAndConditions

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.

ACCEPTANCESTATUSES <IMicrosoftGraphTermsAndConditionsAcceptanceStatus- []>: The list of acceptance statuses for this T&C policy.

  • [Id <String>]: The unique identifier for an entity. Read-only.
  • [AcceptedDateTime <DateTime?>]: DateTime when the terms were last accepted by the user.
  • [AcceptedVersion <Int32?>]: Most recent version number of the T&C accepted by the user.
  • [TermsAndConditions <IMicrosoftGraphTermsAndConditions>]: A termsAndConditions entity represents the metadata and contents of a given Terms and Conditions (T&C) policy. T&C policies' contents are presented to users upon their first attempt to enroll into Intune and subsequently upon edits where an administrator has required re-acceptance. They enable administrators to communicate the provisions to which a user must agree in order to have devices enrolled into Intune.
    • [(Any) <Object>]: This indicates any property can be added to this object.
    • [Id <String>]: The unique identifier for an entity. Read-only.
    • [AcceptanceStatement <String>]: Administrator-supplied explanation of the terms and conditions, typically describing what it means to accept the terms and conditions set out in the T&C policy. This is shown to the user on prompts to accept the T&C policy.
    • [AcceptanceStatuses <IMicrosoftGraphTermsAndConditionsAcceptanceStatus- []>]: The list of acceptance statuses for this T&C policy.
    • [Assignments <IMicrosoftGraphTermsAndConditionsAssignment- []>]: The list of assignments for this T&C policy.
      • [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.
    • [BodyText <String>]: Administrator-supplied body text of the terms and conditions, typically the terms themselves. This is shown to the user on prompts to accept the T&C policy.
    • [CreatedDateTime <DateTime?>]: DateTime the object was created.
    • [Description <String>]: Administrator-supplied description of the T&C policy.
    • [DisplayName <String>]: Administrator-supplied name for the T&C policy.
    • [GroupAssignments <IMicrosoftGraphTermsAndConditionsGroupAssignment- []>]: The list of group assignments for this T&C policy.
      • [Id <String>]: The unique identifier for an entity. Read-only.
      • [TargetGroupId <String>]: Unique identifier of a group that the T&C policy is assigned to.
      • [TermsAndConditions <IMicrosoftGraphTermsAndConditions>]: A termsAndConditions entity represents the metadata and contents of a given Terms and Conditions (T&C) policy. T&C policies' contents are presented to users upon their first attempt to enroll into Intune and subsequently upon edits where an administrator has required re-acceptance. They enable administrators to communicate the provisions to which a user must agree in order to have devices enrolled into Intune.
    • [LastModifiedDateTime <DateTime?>]: DateTime the object was last modified.
    • [ModifiedDateTime <DateTime?>]: DateTime the object was last modified.
    • [RoleScopeTagIds <String- []>]: List of Scope Tags for this Entity instance.
    • [Title <String>]: Administrator-supplied title of the terms and conditions. This is shown to the user on prompts to accept the T&C policy.
    • [Version <Int32?>]: Integer indicating the current version of the terms. Incremented when an administrator makes a change to the terms and wishes to require users to re-accept the modified T&C policy.
  • [UserDisplayName <String>]: Display name of the user whose acceptance the entity represents.
  • [UserPrincipalName <String>]: The userPrincipalName of the User that accepted the term.

ASSIGNMENTS <IMicrosoftGraphTermsAndConditionsAssignment- []>: The list of assignments for this T&C policy.

  • [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 <IMicrosoftGraphTermsAndConditions>: A termsAndConditions entity represents the metadata and contents of a given Terms and Conditions (T&C) policy. T&C policies' contents are presented to users upon their first attempt to enroll into Intune and subsequently upon edits where an administrator has required re-acceptance. They enable administrators to communicate the provisions to which a user must agree in order to have devices enrolled into Intune.

  • [(Any) <Object>]: This indicates any property can be added to this object.
  • [Id <String>]: The unique identifier for an entity. Read-only.
  • [AcceptanceStatement <String>]: Administrator-supplied explanation of the terms and conditions, typically describing what it means to accept the terms and conditions set out in the T&C policy. This is shown to the user on prompts to accept the T&C policy.
  • [AcceptanceStatuses <IMicrosoftGraphTermsAndConditionsAcceptanceStatus- []>]: The list of acceptance statuses for this T&C policy.
    • [Id <String>]: The unique identifier for an entity. Read-only.
    • [AcceptedDateTime <DateTime?>]: DateTime when the terms were last accepted by the user.
    • [AcceptedVersion <Int32?>]: Most recent version number of the T&C accepted by the user.
    • [TermsAndConditions <IMicrosoftGraphTermsAndConditions>]: A termsAndConditions entity represents the metadata and contents of a given Terms and Conditions (T&C) policy. T&C policies' contents are presented to users upon their first attempt to enroll into Intune and subsequently upon edits where an administrator has required re-acceptance. They enable administrators to communicate the provisions to which a user must agree in order to have devices enrolled into Intune.
    • [UserDisplayName <String>]: Display name of the user whose acceptance the entity represents.
    • [UserPrincipalName <String>]: The userPrincipalName of the User that accepted the term.
  • [Assignments <IMicrosoftGraphTermsAndConditionsAssignment- []>]: The list of assignments for this T&C policy.
    • [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.
  • [BodyText <String>]: Administrator-supplied body text of the terms and conditions, typically the terms themselves. This is shown to the user on prompts to accept the T&C policy.
  • [CreatedDateTime <DateTime?>]: DateTime the object was created.
  • [Description <String>]: Administrator-supplied description of the T&C policy.
  • [DisplayName <String>]: Administrator-supplied name for the T&C policy.
  • [GroupAssignments <IMicrosoftGraphTermsAndConditionsGroupAssignment- []>]: The list of group assignments for this T&C policy.
    • [Id <String>]: The unique identifier for an entity. Read-only.
    • [TargetGroupId <String>]: Unique identifier of a group that the T&C policy is assigned to.
    • [TermsAndConditions <IMicrosoftGraphTermsAndConditions>]: A termsAndConditions entity represents the metadata and contents of a given Terms and Conditions (T&C) policy. T&C policies' contents are presented to users upon their first attempt to enroll into Intune and subsequently upon edits where an administrator has required re-acceptance. They enable administrators to communicate the provisions to which a user must agree in order to have devices enrolled into Intune.
  • [LastModifiedDateTime <DateTime?>]: DateTime the object was last modified.
  • [ModifiedDateTime <DateTime?>]: DateTime the object was last modified.
  • [RoleScopeTagIds <String- []>]: List of Scope Tags for this Entity instance.
  • [Title <String>]: Administrator-supplied title of the terms and conditions. This is shown to the user on prompts to accept the T&C policy.
  • [Version <Int32?>]: Integer indicating the current version of the terms. Incremented when an administrator makes a change to the terms and wishes to require users to re-accept the modified T&C policy.

GROUPASSIGNMENTS <IMicrosoftGraphTermsAndConditionsGroupAssignment- []>: The list of group assignments for this T&C policy.

  • [Id <String>]: The unique identifier for an entity. Read-only.
  • [TargetGroupId <String>]: Unique identifier of a group that the T&C policy is assigned to.
  • [TermsAndConditions <IMicrosoftGraphTermsAndConditions>]: A termsAndConditions entity represents the metadata and contents of a given Terms and Conditions (T&C) policy. T&C policies' contents are presented to users upon their first attempt to enroll into Intune and subsequently upon edits where an administrator has required re-acceptance. They enable administrators to communicate the provisions to which a user must agree in order to have devices enrolled into Intune.
    • [(Any) <Object>]: This indicates any property can be added to this object.
    • [Id <String>]: The unique identifier for an entity. Read-only.
    • [AcceptanceStatement <String>]: Administrator-supplied explanation of the terms and conditions, typically describing what it means to accept the terms and conditions set out in the T&C policy. This is shown to the user on prompts to accept the T&C policy.
    • [AcceptanceStatuses <IMicrosoftGraphTermsAndConditionsAcceptanceStatus- []>]: The list of acceptance statuses for this T&C policy.
      • [Id <String>]: The unique identifier for an entity. Read-only.
      • [AcceptedDateTime <DateTime?>]: DateTime when the terms were last accepted by the user.
      • [AcceptedVersion <Int32?>]: Most recent version number of the T&C accepted by the user.
      • [TermsAndConditions <IMicrosoftGraphTermsAndConditions>]: A termsAndConditions entity represents the metadata and contents of a given Terms and Conditions (T&C) policy. T&C policies' contents are presented to users upon their first attempt to enroll into Intune and subsequently upon edits where an administrator has required re-acceptance. They enable administrators to communicate the provisions to which a user must agree in order to have devices enrolled into Intune.
      • [UserDisplayName <String>]: Display name of the user whose acceptance the entity represents.
      • [UserPrincipalName <String>]: The userPrincipalName of the User that accepted the term.
    • [Assignments <IMicrosoftGraphTermsAndConditionsAssignment- []>]: The list of assignments for this T&C policy.
      • [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.
    • [BodyText <String>]: Administrator-supplied body text of the terms and conditions, typically the terms themselves. This is shown to the user on prompts to accept the T&C policy.
    • [CreatedDateTime <DateTime?>]: DateTime the object was created.
    • [Description <String>]: Administrator-supplied description of the T&C policy.
    • [DisplayName <String>]: Administrator-supplied name for the T&C policy.
    • [GroupAssignments <IMicrosoftGraphTermsAndConditionsGroupAssignment- []>]: The list of group assignments for this T&C policy.
    • [LastModifiedDateTime <DateTime?>]: DateTime the object was last modified.
    • [ModifiedDateTime <DateTime?>]: DateTime the object was last modified.
    • [RoleScopeTagIds <String- []>]: List of Scope Tags for this Entity instance.
    • [Title <String>]: Administrator-supplied title of the terms and conditions. This is shown to the user on prompts to accept the T&C policy.
    • [Version <Int32?>]: Integer indicating the current version of the terms. Incremented when an administrator makes a change to the terms and wishes to require users to re-accept the modified T&C policy.

https://learn.microsoft.com/powershell/module/microsoft.graph.beta.devicemanagement.administration/new-mgbetadevicemanagementtermandcondition