Update-MgBetaDeviceManagementTermAndConditionAcceptanceStatus

Update the navigation property acceptanceStatuses in deviceManagement

Note

To view the v1.0 release of this cmdlet, view Update-MgDeviceManagementTermAndConditionAcceptanceStatus

Syntax

Update-MgBetaDeviceManagementTermAndConditionAcceptanceStatus
      -TermsAndConditionsAcceptanceStatusId <String>
      -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>]
Update-MgBetaDeviceManagementTermAndConditionAcceptanceStatus
      -TermsAndConditionsAcceptanceStatusId <String>
      -TermsAndConditionsId <String>
      -BodyParameter <IMicrosoftGraphTermsAndConditionsAcceptanceStatus>
      [-ResponseHeadersVariable <String>]
      [-Headers <IDictionary>]
      [-ProgressAction <ActionPreference>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Update-MgBetaDeviceManagementTermAndConditionAcceptanceStatus
      -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>]
Update-MgBetaDeviceManagementTermAndConditionAcceptanceStatus
      -InputObject <IDeviceManagementAdministrationIdentity>
      -BodyParameter <IMicrosoftGraphTermsAndConditionsAcceptanceStatus>
      [-ResponseHeadersVariable <String>]
      [-Headers <IDictionary>]
      [-ProgressAction <ActionPreference>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

Update the navigation property acceptanceStatuses in deviceManagement

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

-TermsAndConditionsAcceptanceStatusId

The unique identifier of termsAndConditionsAcceptanceStatus

Type:String
Position:Named
Default value:None
Required:True
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.Beta.PowerShell.Models.IDeviceManagementAdministrationIdentity

Microsoft.Graph.Beta.PowerShell.Models.IMicrosoftGraphTermsAndConditionsAcceptanceStatus

System.Collections.IDictionary

Outputs

Microsoft.Graph.Beta.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.
        • [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.

INPUTOBJECT <IDeviceManagementAdministrationIdentity>: Identity Parameter

  • [AuditEventId <String>]: The unique identifier of auditEvent
  • [CartToClassAssociationId <String>]: The unique identifier of cartToClassAssociation
  • [CloudPcAuditEventId <String>]: The unique identifier of cloudPcAuditEvent
  • [CloudPcBulkActionId <String>]: The unique identifier of cloudPcBulkAction
  • [CloudPcDeviceImageId <String>]: The unique identifier of cloudPcDeviceImage
  • [CloudPcExportJobId <String>]: The unique identifier of cloudPcExportJob
  • [CloudPcExternalPartnerSettingId <String>]: The unique identifier of cloudPcExternalPartnerSetting
  • [CloudPcFrontLineServicePlanId <String>]: The unique identifier of cloudPcFrontLineServicePlan
  • [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
  • [CloudPcServicePlanId <String>]: The unique identifier of cloudPcServicePlan
  • [CloudPcSnapshotId <String>]: The unique identifier of cloudPcSnapshot
  • [CloudPcSupportedRegionId <String>]: The unique identifier of cloudPcSupportedRegion
  • [CloudPcUserSettingAssignmentId <String>]: The unique identifier of cloudPcUserSettingAssignment
  • [CloudPcUserSettingId <String>]: The unique identifier of cloudPcUserSetting
  • [ComanagementEligibleDeviceId <String>]: The unique identifier of comanagementEligibleDevice
  • [ComplianceManagementPartnerId <String>]: The unique identifier of complianceManagementPartner
  • [DeviceAndAppManagementRoleAssignmentId <String>]: The unique identifier of deviceAndAppManagementRoleAssignment
  • [DeviceManagementDomainJoinConnectorId <String>]: The unique identifier of deviceManagementDomainJoinConnector
  • [DeviceManagementExchangeConnectorId <String>]: The unique identifier of deviceManagementExchangeConnector
  • [DeviceManagementExchangeOnPremisesPolicyId <String>]: The unique identifier of deviceManagementExchangeOnPremisesPolicy
  • [DeviceManagementPartnerId <String>]: The unique identifier of deviceManagementPartner
  • [GroupPolicyCategoryId <String>]: The unique identifier of groupPolicyCategory
  • [GroupPolicyCategoryId1 <String>]: The unique identifier of groupPolicyCategory
  • [GroupPolicyDefinitionFileId <String>]: The unique identifier of groupPolicyDefinitionFile
  • [GroupPolicyDefinitionId <String>]: The unique identifier of groupPolicyDefinition
  • [GroupPolicyMigrationReportId <String>]: The unique identifier of groupPolicyMigrationReport
  • [GroupPolicyObjectFileId <String>]: The unique identifier of groupPolicyObjectFile
  • [GroupPolicyOperationId <String>]: The unique identifier of groupPolicyOperation
  • [GroupPolicyPresentationId <String>]: The unique identifier of groupPolicyPresentation
  • [GroupPolicySettingMappingId <String>]: The unique identifier of groupPolicySettingMapping
  • [GroupPolicyUploadedDefinitionFileId <String>]: The unique identifier of groupPolicyUploadedDefinitionFile
  • [IntuneBrandingProfileAssignmentId <String>]: The unique identifier of intuneBrandingProfileAssignment
  • [IntuneBrandingProfileId <String>]: The unique identifier of intuneBrandingProfile
  • [IosUpdateDeviceStatusId <String>]: The unique identifier of iosUpdateDeviceStatus
  • [ManagedAllDeviceCertificateStateId <String>]: The unique identifier of managedAllDeviceCertificateState
  • [MobileThreatDefenseConnectorId <String>]: The unique identifier of mobileThreatDefenseConnector
  • [NdesConnectorId <String>]: The unique identifier of ndesConnector
  • [RemoteAssistancePartnerId <String>]: The unique identifier of remoteAssistancePartner
  • [ResourceOperationId <String>]: The unique identifier of resourceOperation
  • [RestrictedAppsViolationId <String>]: The unique identifier of restrictedAppsViolation
  • [RoleAssignmentId <String>]: The unique identifier of roleAssignment
  • [RoleDefinitionId <String>]: The unique identifier of roleDefinition
  • [RoleScopeTagAutoAssignmentId <String>]: The unique identifier of roleScopeTagAutoAssignment
  • [RoleScopeTagId <String>]: The unique identifier of roleScopeTag
  • [TelecomExpenseManagementPartnerId <String>]: The unique identifier of telecomExpenseManagementPartner
  • [TermsAndConditionsAcceptanceStatusId <String>]: The unique identifier of termsAndConditionsAcceptanceStatus
  • [TermsAndConditionsAssignmentId <String>]: The unique identifier of termsAndConditionsAssignment
  • [TermsAndConditionsGroupAssignmentId <String>]: The unique identifier of termsAndConditionsGroupAssignment
  • [TermsAndConditionsId <String>]: The unique identifier of termsAndConditions
  • [UnsupportedGroupPolicyExtensionId <String>]: The unique identifier of unsupportedGroupPolicyExtension
  • [UserId <String>]: The unique identifier of user
  • [UserPfxCertificateId <String>]: The unique identifier of userPFXCertificate

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.
    • [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.

https://learn.microsoft.com/powershell/module/microsoft.graph.beta.devicemanagement.administration/update-mgbetadevicemanagementtermandconditionacceptancestatus