Share via


Request-MgBetaDeviceManagementManagedDeviceRemoteAssistance

Request remote assistance

Note

To view the v1.0 release of this cmdlet, view Request-MgDeviceManagementManagedDeviceRemoteAssistance

Syntax

Request-MgBetaDeviceManagementManagedDeviceRemoteAssistance
       -ManagedDeviceId <String>
       [-ResponseHeadersVariable <String>]
       [-Headers <IDictionary>]
       [-PassThru]
       [-ProgressAction <ActionPreference>]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]
Request-MgBetaDeviceManagementManagedDeviceRemoteAssistance
       -InputObject <IDeviceManagementIdentity>
       [-ResponseHeadersVariable <String>]
       [-Headers <IDictionary>]
       [-PassThru]
       [-ProgressAction <ActionPreference>]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

Description

Request remote assistance

Permissions

Permission type Permissions (from least to most privileged)
Delegated (work or school account) DeviceManagementManagedDevices.ReadWrite.All, DeviceManagementConfiguration.ReadWrite.All,
Delegated (personal Microsoft account) Not supported
Application DeviceManagementManagedDevices.ReadWrite.All, DeviceManagementConfiguration.ReadWrite.All,

Parameters

-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

-InputObject

Identity Parameter To construct, see NOTES section for INPUTOBJECT properties and create a hash table.

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

-ManagedDeviceId

The unique identifier of managedDevice

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

-PassThru

Returns true when the command succeeds

Type:SwitchParameter
Position:Named
Default value:False
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

-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.IDeviceManagementIdentity

System.Collections.IDictionary

Outputs

System.Boolean

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.

INPUTOBJECT <IDeviceManagementIdentity>: Identity Parameter

  • [AdvancedThreatProtectionOnboardingDeviceSettingStateId <String>]: The unique identifier of advancedThreatProtectionOnboardingDeviceSettingState
  • [AlertRecordId <String>]: The unique identifier of alertRecord
  • [AlertRuleId <String>]: The unique identifier of alertRule
  • [AndroidForWorkAppConfigurationSchemaId <String>]: The unique identifier of androidForWorkAppConfigurationSchema
  • [AndroidManagedStoreAppConfigurationSchemaId <String>]: The unique identifier of androidManagedStoreAppConfigurationSchema
  • [AppLogCollectionRequestId <String>]: The unique identifier of appLogCollectionRequest
  • [AssignmentFilterEvaluationStatusDetailsId <String>]: The unique identifier of assignmentFilterEvaluationStatusDetails
  • [BrowserSharedCookieId <String>]: The unique identifier of browserSharedCookie
  • [BrowserSiteId <String>]: The unique identifier of browserSite
  • [BrowserSiteListId <String>]: The unique identifier of browserSiteList
  • [DataSharingConsentId <String>]: The unique identifier of dataSharingConsent
  • [DetectedAppId <String>]: The unique identifier of detectedApp
  • [DeviceAndAppManagementAssignmentFilterId <String>]: The unique identifier of deviceAndAppManagementAssignmentFilter
  • [DeviceCategoryId <String>]: The unique identifier of deviceCategory
  • [DeviceComplianceActionItemId <String>]: The unique identifier of deviceComplianceActionItem
  • [DeviceComplianceDeviceStatusId <String>]: The unique identifier of deviceComplianceDeviceStatus
  • [DeviceCompliancePolicyAssignmentId <String>]: The unique identifier of deviceCompliancePolicyAssignment
  • [DeviceCompliancePolicyId <String>]: The unique identifier of deviceCompliancePolicy
  • [DeviceCompliancePolicySettingStateSummaryId <String>]: The unique identifier of deviceCompliancePolicySettingStateSummary
  • [DeviceCompliancePolicyStateId <String>]: The unique identifier of deviceCompliancePolicyState
  • [DeviceComplianceScheduledActionForRuleId <String>]: The unique identifier of deviceComplianceScheduledActionForRule
  • [DeviceComplianceSettingStateId <String>]: The unique identifier of deviceComplianceSettingState
  • [DeviceComplianceUserStatusId <String>]: The unique identifier of deviceComplianceUserStatus
  • [DeviceConfigurationAssignmentId <String>]: The unique identifier of deviceConfigurationAssignment
  • [DeviceConfigurationConflictSummaryId <String>]: The unique identifier of deviceConfigurationConflictSummary
  • [DeviceConfigurationDeviceStatusId <String>]: The unique identifier of deviceConfigurationDeviceStatus
  • [DeviceConfigurationGroupAssignmentId <String>]: The unique identifier of deviceConfigurationGroupAssignment
  • [DeviceConfigurationId <String>]: The unique identifier of deviceConfiguration
  • [DeviceConfigurationStateId <String>]: The unique identifier of deviceConfigurationState
  • [DeviceConfigurationUserStatusId <String>]: The unique identifier of deviceConfigurationUserStatus
  • [DeviceHealthScriptAssignmentId <String>]: The unique identifier of deviceHealthScriptAssignment
  • [DeviceHealthScriptDeviceStateId <String>]: The unique identifier of deviceHealthScriptDeviceState
  • [DeviceHealthScriptId <String>]: The unique identifier of deviceHealthScript
  • [DeviceId <String>]: Property in multi-part unique identifier of deviceHealthScriptPolicyState
  • [DeviceLogCollectionResponseId <String>]: The unique identifier of deviceLogCollectionResponse
  • [DeviceManagementComplianceActionItemId <String>]: The unique identifier of deviceManagementComplianceActionItem
  • [DeviceManagementCompliancePolicyId <String>]: The unique identifier of deviceManagementCompliancePolicy
  • [DeviceManagementComplianceScheduledActionForRuleId <String>]: The unique identifier of deviceManagementComplianceScheduledActionForRule
  • [DeviceManagementConfigurationPolicyAssignmentId <String>]: The unique identifier of deviceManagementConfigurationPolicyAssignment
  • [DeviceManagementConfigurationPolicyId <String>]: The unique identifier of deviceManagementConfigurationPolicy
  • [DeviceManagementConfigurationPolicyTemplateId <String>]: The unique identifier of deviceManagementConfigurationPolicyTemplate
  • [DeviceManagementConfigurationSettingDefinitionId <String>]: The unique identifier of deviceManagementConfigurationSettingDefinition
  • [DeviceManagementConfigurationSettingId <String>]: The unique identifier of deviceManagementConfigurationSetting
  • [DeviceManagementConfigurationSettingTemplateId <String>]: The unique identifier of deviceManagementConfigurationSettingTemplate
  • [DeviceManagementDerivedCredentialSettingsId <String>]: The unique identifier of deviceManagementDerivedCredentialSettings
  • [DeviceManagementIntentAssignmentId <String>]: The unique identifier of deviceManagementIntentAssignment
  • [DeviceManagementIntentDeviceSettingStateSummaryId <String>]: The unique identifier of deviceManagementIntentDeviceSettingStateSummary
  • [DeviceManagementIntentDeviceStateId <String>]: The unique identifier of deviceManagementIntentDeviceState
  • [DeviceManagementIntentId <String>]: The unique identifier of deviceManagementIntent
  • [DeviceManagementIntentSettingCategoryId <String>]: The unique identifier of deviceManagementIntentSettingCategory
  • [DeviceManagementIntentUserStateId <String>]: The unique identifier of deviceManagementIntentUserState
  • [DeviceManagementResourceAccessProfileAssignmentId <String>]: The unique identifier of deviceManagementResourceAccessProfileAssignment
  • [DeviceManagementResourceAccessProfileBaseId <String>]: The unique identifier of deviceManagementResourceAccessProfileBase
  • [DeviceManagementScriptAssignmentId <String>]: The unique identifier of deviceManagementScriptAssignment
  • [DeviceManagementScriptDeviceStateId <String>]: The unique identifier of deviceManagementScriptDeviceState
  • [DeviceManagementScriptGroupAssignmentId <String>]: The unique identifier of deviceManagementScriptGroupAssignment
  • [DeviceManagementScriptId <String>]: The unique identifier of deviceManagementScript
  • [DeviceManagementScriptUserStateId <String>]: The unique identifier of deviceManagementScriptUserState
  • [DeviceManagementSettingCategoryId <String>]: The unique identifier of deviceManagementSettingCategory
  • [DeviceManagementSettingDefinitionId <String>]: The unique identifier of deviceManagementSettingDefinition
  • [DeviceManagementSettingInstanceId <String>]: The unique identifier of deviceManagementSettingInstance
  • [DeviceManagementTemplateId <String>]: The unique identifier of deviceManagementTemplate
  • [DeviceManagementTemplateId1 <String>]: The unique identifier of deviceManagementTemplate
  • [DeviceManagementTemplateSettingCategoryId <String>]: The unique identifier of deviceManagementTemplateSettingCategory
  • [DeviceManagementTroubleshootingEventId <String>]: The unique identifier of deviceManagementTroubleshootingEvent
  • [DeviceShellScriptId <String>]: The unique identifier of deviceShellScript
  • [EmbeddedSimActivationCodePoolAssignmentId <String>]: The unique identifier of embeddedSIMActivationCodePoolAssignment
  • [EmbeddedSimActivationCodePoolId <String>]: The unique identifier of embeddedSIMActivationCodePool
  • [EmbeddedSimDeviceStateId <String>]: The unique identifier of embeddedSIMDeviceState
  • [GroupPolicyConfigurationAssignmentId <String>]: The unique identifier of groupPolicyConfigurationAssignment
  • [GroupPolicyConfigurationId <String>]: The unique identifier of groupPolicyConfiguration
  • [GroupPolicyDefinitionValueId <String>]: The unique identifier of groupPolicyDefinitionValue
  • [GroupPolicyPresentationValueId <String>]: The unique identifier of groupPolicyPresentationValue
  • [Id <String>]: Property in multi-part unique identifier of deviceHealthScriptPolicyState
  • [LocalizedNotificationMessageId <String>]: The unique identifier of localizedNotificationMessage
  • [MacOSSoftwareUpdateAccountSummaryId <String>]: The unique identifier of macOSSoftwareUpdateAccountSummary
  • [MacOSSoftwareUpdateCategorySummaryId <String>]: The unique identifier of macOSSoftwareUpdateCategorySummary
  • [MacOSSoftwareUpdateStateSummaryId <String>]: The unique identifier of macOSSoftwareUpdateStateSummary
  • [MalwareStateForWindowsDeviceId <String>]: The unique identifier of malwareStateForWindowsDevice
  • [ManagedDeviceCleanupRuleId <String>]: The unique identifier of managedDeviceCleanupRule
  • [ManagedDeviceEncryptionStateId <String>]: The unique identifier of managedDeviceEncryptionState
  • [ManagedDeviceId <String>]: The unique identifier of managedDevice
  • [ManagedDeviceMobileAppConfigurationStateId <String>]: The unique identifier of managedDeviceMobileAppConfigurationState
  • [ManagedDeviceWindowsOperatingSystemImageId <String>]: The unique identifier of managedDeviceWindowsOperatingSystemImage
  • [MicrosoftTunnelConfigurationId <String>]: The unique identifier of microsoftTunnelConfiguration
  • [MicrosoftTunnelHealthThresholdId <String>]: The unique identifier of microsoftTunnelHealthThreshold
  • [MicrosoftTunnelServerId <String>]: The unique identifier of microsoftTunnelServer
  • [MicrosoftTunnelServerLogCollectionResponseId <String>]: The unique identifier of microsoftTunnelServerLogCollectionResponse
  • [MicrosoftTunnelSiteId <String>]: The unique identifier of microsoftTunnelSite
  • [MobileAppTroubleshootingEventId <String>]: The unique identifier of mobileAppTroubleshootingEvent
  • [NotificationMessageTemplateId <String>]: The unique identifier of notificationMessageTemplate
  • [Platform <DevicePlatformType?>]: Usage: platform='{platform}'
  • [PolicyId <String>]: Property in multi-part unique identifier of deviceHealthScriptPolicyState
  • [RemoteActionAuditId <String>]: The unique identifier of remoteActionAudit
  • [SecretReferenceValueId <String>]: Usage: secretReferenceValueId='{secretReferenceValueId}'
  • [SecurityBaselineSettingStateId <String>]: The unique identifier of securityBaselineSettingState
  • [SecurityBaselineStateId <String>]: The unique identifier of securityBaselineState
  • [SettingStateDeviceSummaryId <String>]: The unique identifier of settingStateDeviceSummary
  • [TemplateId <String>]: Usage: templateId='{templateId}'
  • [Upn <String>]: Usage: upn='{upn}'
  • [UserPrincipalName <String>]: Usage: userPrincipalName='{userPrincipalName}'
  • [WindowsDeviceMalwareStateId <String>]: The unique identifier of windowsDeviceMalwareState
  • [WindowsInformationProtectionAppLearningSummaryId <String>]: The unique identifier of windowsInformationProtectionAppLearningSummary
  • [WindowsInformationProtectionNetworkLearningSummaryId <String>]: The unique identifier of windowsInformationProtectionNetworkLearningSummary
  • [WindowsMalwareInformationId <String>]: The unique identifier of windowsMalwareInformation
  • [WindowsQualityUpdateProfileAssignmentId <String>]: The unique identifier of windowsQualityUpdateProfileAssignment
  • [WindowsQualityUpdateProfileId <String>]: The unique identifier of windowsQualityUpdateProfile

https://learn.microsoft.com/powershell/module/microsoft.graph.beta.devicemanagement/request-mgbetadevicemanagementmanageddeviceremoteassistance