New-MgDeviceManagementTermAndConditionAcceptanceStatus

Module:

Microsoft.Graph.DeviceManagement.Administration

Create a new termsAndConditionsAcceptanceStatus object.

Note

To view the beta release of this cmdlet, view New-MgBetaDeviceManagementTermAndConditionAcceptanceStatus

Syntax

New-MgDeviceManagementTermAndConditionAcceptanceStatus
   -TermsAndConditionsId <String>
   [-ResponseHeadersVariable <String>]
   [-AcceptedDateTime <DateTime>]
   [-AcceptedVersion <Int32>]
   [-AdditionalProperties <Hashtable>]
   [-Id <String>]
   [-TermsAndConditions <IMicrosoftGraphTermsAndConditions>]
   [-UserDisplayName <String>]
   [-UserPrincipalName <String>]
   [-Headers <IDictionary>]
   [-ProgressAction <ActionPreference>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-MgDeviceManagementTermAndConditionAcceptanceStatus
   -TermsAndConditionsId <String>
   -BodyParameter <IMicrosoftGraphTermsAndConditionsAcceptanceStatus>
   [-ResponseHeadersVariable <String>]
   [-Headers <IDictionary>]
   [-ProgressAction <ActionPreference>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-MgDeviceManagementTermAndConditionAcceptanceStatus
   -InputObject <IDeviceManagementAdministrationIdentity>
   [-ResponseHeadersVariable <String>]
   [-AcceptedDateTime <DateTime>]
   [-AcceptedVersion <Int32>]
   [-AdditionalProperties <Hashtable>]
   [-Id <String>]
   [-TermsAndConditions <IMicrosoftGraphTermsAndConditions>]
   [-UserDisplayName <String>]
   [-UserPrincipalName <String>]
   [-Headers <IDictionary>]
   [-ProgressAction <ActionPreference>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-MgDeviceManagementTermAndConditionAcceptanceStatus
   -InputObject <IDeviceManagementAdministrationIdentity>
   -BodyParameter <IMicrosoftGraphTermsAndConditionsAcceptanceStatus>
   [-ResponseHeadersVariable <String>]
   [-Headers <IDictionary>]
   [-ProgressAction <ActionPreference>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Create a new termsAndConditionsAcceptanceStatus object.

Examples

Example 1: Code snippet

Import-Module Microsoft.Graph.DeviceManagement.Administration

$params = @{
	"@odata.type" = "#microsoft.graph.termsAndConditionsAcceptanceStatus"
	userDisplayName = "User Display Name value"
	acceptedVersion = 15
	acceptedDateTime = [System.DateTime]::Parse("2016-12-31T23:57:43.6165506-08:00")
	userPrincipalName = "User Principal Name value"
}

New-MgDeviceManagementTermAndConditionAcceptanceStatus -TermsAndConditionsId $termsAndConditionsId -BodyParameter $params

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

Parameters

-AcceptedDateTime

DateTime when the terms were last accepted by the user.

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

-AcceptedVersion

Most recent version number of the T&C accepted by the user.

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

-BodyParameter

A termsAndConditionsAcceptanceStatus entity represents the acceptance status of a given Terms and Conditions (T&C) policy by a given user. Users must accept the most up-to-date version of the terms in order to retain access to the Company Portal. To construct, see NOTES section for BODYPARAMETER properties and create a hash table.

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

-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:	IDeviceManagementAdministrationIdentity
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
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

-TermsAndConditions

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 TERMSANDCONDITIONS properties and create a hash table.

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

-TermsAndConditionsId

The unique identifier of termsAndConditions

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

-UserDisplayName

Display name of the user whose acceptance the entity represents.

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

-UserPrincipalName

The userPrincipalName of the User that accepted the term.

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.PowerShell.Models.IDeviceManagementAdministrationIdentity

Microsoft.Graph.PowerShell.Models.IMicrosoftGraphTermsAndConditionsAcceptanceStatus

System.Collections.IDictionary

Outputs

Microsoft.Graph.PowerShell.Models.IMicrosoftGraphTermsAndConditionsAcceptanceStatus

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 <IMicrosoftGraphTermsAndConditionsAcceptanceStatus>: A termsAndConditionsAcceptanceStatus entity represents the acceptance status of a given Terms and Conditions (T&C) policy by a given user. Users must accept the most up-to-date version of the terms in order to retain access to the Company Portal.

• [(Any) <Object>]: This indicates any property can be added to this object.
• [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.
  • [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.
  • [LastModifiedDateTime <DateTime?>]: DateTime the object was last modified.
  • [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.

INPUTOBJECT <IDeviceManagementAdministrationIdentity>: Identity Parameter

• [AuditEventId <String>]: The unique identifier of auditEvent
• [CloudPcAuditEventId <String>]: The unique identifier of cloudPcAuditEvent
• [CloudPcDeviceImageId <String>]: The unique identifier of cloudPcDeviceImage
• [CloudPcGalleryImageId <String>]: The unique identifier of cloudPcGalleryImage
• [CloudPcId <String>]: The unique identifier of cloudPC
• [CloudPcOnPremisesConnectionId <String>]: The unique identifier of cloudPcOnPremisesConnection
• [CloudPcProvisioningPolicyAssignmentId <String>]: The unique identifier of cloudPcProvisioningPolicyAssignment
• [CloudPcProvisioningPolicyId <String>]: The unique identifier of cloudPcProvisioningPolicy
• [CloudPcUserSettingAssignmentId <String>]: The unique identifier of cloudPcUserSettingAssignment
• [CloudPcUserSettingId <String>]: The unique identifier of cloudPcUserSetting
• [ComplianceManagementPartnerId <String>]: The unique identifier of complianceManagementPartner
• [DeviceAndAppManagementRoleAssignmentId <String>]: The unique identifier of deviceAndAppManagementRoleAssignment
• [DeviceManagementExchangeConnectorId <String>]: The unique identifier of deviceManagementExchangeConnector
• [DeviceManagementPartnerId <String>]: The unique identifier of deviceManagementPartner
• [IosUpdateDeviceStatusId <String>]: The unique identifier of iosUpdateDeviceStatus
• [MobileThreatDefenseConnectorId <String>]: The unique identifier of mobileThreatDefenseConnector
• [RemoteAssistancePartnerId <String>]: The unique identifier of remoteAssistancePartner
• [ResourceOperationId <String>]: The unique identifier of resourceOperation
• [RoleAssignmentId <String>]: The unique identifier of roleAssignment
• [RoleDefinitionId <String>]: The unique identifier of roleDefinition
• [TelecomExpenseManagementPartnerId <String>]: The unique identifier of telecomExpenseManagementPartner
• [TermsAndConditionsAcceptanceStatusId <String>]: The unique identifier of termsAndConditionsAcceptanceStatus
• [TermsAndConditionsAssignmentId <String>]: The unique identifier of termsAndConditionsAssignment
• [TermsAndConditionsId <String>]: The unique identifier of termsAndConditions
• [UserId <String>]: The unique identifier of 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.
  • [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.
• [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.
• [LastModifiedDateTime <DateTime?>]: DateTime the object was last modified.
• [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.

Related Links

• https://learn.microsoft.com/powershell/module/microsoft.graph.devicemanagement.administration/new-mgdevicemanagementtermandconditionacceptancestatus
• https://learn.microsoft.com/graph/api/intune-companyterms-termsandconditionsacceptancestatus-create?view=graph-rest-1.0