This example shows how to use the Update-MgDeviceManagementMobileThreatDefenseConnector Cmdlet.
Parameters
-AdditionalProperties
Additional Parameters
Parameter properties
Type:
System.Collections.Hashtable
Supports wildcards:
False
DontShow:
False
Parameter sets
UpdateViaIdentityExpanded
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
UpdateExpanded
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
-AllowPartnerToCollectIosApplicationMetadata
When TRUE, indicates the Mobile Threat Defense partner may collect metadata about installed applications from Intune for iOS devices.
When FALSE, indicates the Mobile Threat Defense partner may not collect metadata about installed applications from Intune for iOS devices.
Default value is FALSE.
When TRUE, indicates the Mobile Threat Defense partner may collect metadata about personally installed applications from Intune for iOS devices.
When FALSE, indicates the Mobile Threat Defense partner may not collect metadata about personally installed applications from Intune for iOS devices.
Default value is FALSE.
Parameter properties
Type:
System.Management.Automation.SwitchParameter
Default value:
False
Supports wildcards:
False
DontShow:
False
Parameter sets
UpdateViaIdentityExpanded
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
UpdateExpanded
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
-AndroidDeviceBlockedOnMissingPartnerData
When TRUE, indicates that Intune must receive data from the Mobile Threat Defense partner prior to marking an Android device compliant.
When FALSE, indicates that Intune may mark an Android device compliant before receiving data from the Mobile Threat Defense partner.
Parameter properties
Type:
System.Management.Automation.SwitchParameter
Default value:
False
Supports wildcards:
False
DontShow:
False
Parameter sets
UpdateViaIdentityExpanded
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
UpdateExpanded
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
-AndroidEnabled
When TRUE, indicates that data from the Mobile Threat Defense partner will be used during compliance evaluations for Android devices.
When FALSE, indicates that data from the Mobile Threat Defense partner will not be used during compliance evaluations for Android devices.
Default value is FALSE.
Parameter properties
Type:
System.Management.Automation.SwitchParameter
Default value:
False
Supports wildcards:
False
DontShow:
False
Parameter sets
UpdateViaIdentityExpanded
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
UpdateExpanded
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
-AndroidMobileApplicationManagementEnabled
When TRUE, inidicates that data from the Mobile Threat Defense partner can be used during Mobile Application Management (MAM) evaluations for Android devices.
When FALSE, inidicates that data from the Mobile Threat Defense partner should not be used during Mobile Application Management (MAM) evaluations for Android devices.
Only one partner per platform may be enabled for Mobile Application Management (MAM) evaluation.
Default value is FALSE.
Parameter properties
Type:
System.Management.Automation.SwitchParameter
Default value:
False
Supports wildcards:
False
DontShow:
False
Parameter sets
UpdateViaIdentityExpanded
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
UpdateExpanded
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
-BodyParameter
Entity which represents a connection to Mobile Threat Defense partner.
To construct, see NOTES section for BODYPARAMETER properties and create a hash table.
When TRUE, indicates that Intune must receive data from the Mobile Threat Defense partner prior to marking a device compliant.
When FALSE, indicates that Intune may not recieve data from Mobile Threat Defense partner prior to making device compliant.
Default value is FALSE.
Parameter properties
Type:
System.Management.Automation.SwitchParameter
Default value:
False
Supports wildcards:
False
DontShow:
False
Parameter sets
UpdateViaIdentityExpanded
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
UpdateExpanded
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
-IosEnabled
When TRUE, indicates that data from the Mobile Threat Defense partner will be used during compliance evaluations for iOS devices.
When FALSE, indicates that data from the Mobile Threat Defense partner will not be used during compliance evaluations for iOS devices.
Default value is FALSE.
Parameter properties
Type:
System.Management.Automation.SwitchParameter
Default value:
False
Supports wildcards:
False
DontShow:
False
Parameter sets
UpdateViaIdentityExpanded
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
UpdateExpanded
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
-IosMobileApplicationManagementEnabled
When TRUE, inidicates that data from the Mobile Threat Defense partner can be used during Mobile Application Management (MAM) evaluations for iOS devices.
When FALSE, inidicates that data from the Mobile Threat Defense partner should not be used during Mobile Application Management (MAM) evaluations for iOS devices.
Only one partner per platform may be enabled for Mobile Application Management (MAM) evaluation.
Default value is FALSE.
Parameter properties
Type:
System.Management.Automation.SwitchParameter
Default value:
False
Supports wildcards:
False
DontShow:
False
Parameter sets
UpdateViaIdentityExpanded
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
UpdateExpanded
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
-LastHeartbeatDateTime
DateTime of last Heartbeat recieved from the Mobile Threat Defense partner
Parameter properties
Type:
System.DateTime
Supports wildcards:
False
DontShow:
False
Parameter sets
UpdateViaIdentityExpanded
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
UpdateExpanded
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
-MicrosoftDefenderForEndpointAttachEnabled
When TRUE, inidicates that configuration profile management via Microsoft Defender for Endpoint is enabled.
When FALSE, inidicates that configuration profile management via Microsoft Defender for Endpoint is disabled.
Default value is FALSE.
Parameter properties
Type:
System.Management.Automation.SwitchParameter
Default value:
False
Supports wildcards:
False
DontShow:
False
Parameter sets
UpdateViaIdentityExpanded
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
UpdateExpanded
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
-MobileThreatDefenseConnectorId
The unique identifier of mobileThreatDefenseConnector
Indicates the number of days without receiving a heartbeat from a Mobile Threat Defense partner before the partner is marked as unresponsive.
Intune will the ignore the data from this Mobile Threat Defense Partner for next compliance calculation.
Parameter properties
Type:
System.Int32
Default value:
0
Supports wildcards:
False
DontShow:
False
Parameter sets
UpdateViaIdentityExpanded
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
UpdateExpanded
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
-PartnerUnsupportedOSVersionBlocked
When TRUE, indicates that Intune will mark devices noncompliant on enabled platforms that do not meet the minimum version requirements of the Mobile Threat Defense partner.
When FALSE, indicates that Intune will not mark devices noncompliant on enabled platforms that do not meet the minimum version requirements of the Mobile Threat Defense partner.
Default value is FALSE.
Parameter properties
Type:
System.Management.Automation.SwitchParameter
Default value:
False
Supports wildcards:
False
DontShow:
False
Parameter sets
UpdateViaIdentityExpanded
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
UpdateExpanded
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
-Proxy
The URI for the proxy server to use
Parameter properties
Type:
System.Uri
Supports wildcards:
False
DontShow:
False
Parameter sets
(All)
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
-ProxyCredential
Credentials for a proxy server to use for the remote call
Parameter properties
Type:
System.Management.Automation.PSCredential
Supports wildcards:
False
DontShow:
False
Parameter sets
(All)
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
-ProxyUseDefaultCredentials
Use the default credentials for the proxy
Parameter properties
Type:
System.Management.Automation.SwitchParameter
Default value:
False
Supports wildcards:
False
DontShow:
False
Parameter sets
(All)
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
-ResponseHeadersVariable
Optional Response Headers Variable.
Parameter properties
Type:
System.String
Supports wildcards:
False
DontShow:
False
Aliases:
RHV
Parameter sets
(All)
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
-WhatIf
Runs the command in a mode that only reports what would happen without performing the actions.
Parameter properties
Type:
System.Management.Automation.SwitchParameter
Supports wildcards:
False
DontShow:
False
Aliases:
wi
Parameter sets
(All)
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
-WindowsDeviceBlockedOnMissingPartnerData
When TRUE, indicates that Intune must receive data from the data sync partner prior to marking a device compliant for Windows.
When FALSE, indicates that Intune may mark a device compliant without receiving data from the data sync partner for Windows.
Default value is FALSE.
Parameter properties
Type:
System.Management.Automation.SwitchParameter
Default value:
False
Supports wildcards:
False
DontShow:
False
Parameter sets
UpdateViaIdentityExpanded
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
UpdateExpanded
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
-WindowsEnabled
When TRUE, indicates that data from the Mobile Threat Defense partner will be used during compliance evaluations for Windows.
When FALSE, indicates that data from the Mobile Threat Defense partner will not be used during compliance evaluations for Windows.
Default value is FALSE.
Parameter properties
Type:
System.Management.Automation.SwitchParameter
Default value:
False
Supports wildcards:
False
DontShow:
False
Parameter sets
UpdateViaIdentityExpanded
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
UpdateExpanded
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
CommonParameters
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable,
-InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable,
-ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see
about_CommonParameters.
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 <IMicrosoftGraphMobileThreatDefenseConnector>: Entity which represents a connection to Mobile Threat Defense partner.
[(Any) <Object>]: This indicates any property can be added to this object.
[Id <String>]: The unique identifier for an entity.
Read-only.
[AllowPartnerToCollectIosApplicationMetadata <Boolean?>]: When TRUE, indicates the Mobile Threat Defense partner may collect metadata about installed applications from Intune for iOS devices.
When FALSE, indicates the Mobile Threat Defense partner may not collect metadata about installed applications from Intune for iOS devices.
Default value is FALSE.
[AllowPartnerToCollectIosPersonalApplicationMetadata <Boolean?>]: When TRUE, indicates the Mobile Threat Defense partner may collect metadata about personally installed applications from Intune for iOS devices.
When FALSE, indicates the Mobile Threat Defense partner may not collect metadata about personally installed applications from Intune for iOS devices.
Default value is FALSE.
[AndroidDeviceBlockedOnMissingPartnerData <Boolean?>]: When TRUE, indicates that Intune must receive data from the Mobile Threat Defense partner prior to marking an Android device compliant.
When FALSE, indicates that Intune may mark an Android device compliant before receiving data from the Mobile Threat Defense partner.
[AndroidEnabled <Boolean?>]: When TRUE, indicates that data from the Mobile Threat Defense partner will be used during compliance evaluations for Android devices.
When FALSE, indicates that data from the Mobile Threat Defense partner will not be used during compliance evaluations for Android devices.
Default value is FALSE.
[AndroidMobileApplicationManagementEnabled <Boolean?>]: When TRUE, inidicates that data from the Mobile Threat Defense partner can be used during Mobile Application Management (MAM) evaluations for Android devices.
When FALSE, inidicates that data from the Mobile Threat Defense partner should not be used during Mobile Application Management (MAM) evaluations for Android devices.
Only one partner per platform may be enabled for Mobile Application Management (MAM) evaluation.
Default value is FALSE.
[IosDeviceBlockedOnMissingPartnerData <Boolean?>]: When TRUE, indicates that Intune must receive data from the Mobile Threat Defense partner prior to marking a device compliant.
When FALSE, indicates that Intune may not recieve data from Mobile Threat Defense partner prior to making device compliant.
Default value is FALSE.
[IosEnabled <Boolean?>]: When TRUE, indicates that data from the Mobile Threat Defense partner will be used during compliance evaluations for iOS devices.
When FALSE, indicates that data from the Mobile Threat Defense partner will not be used during compliance evaluations for iOS devices.
Default value is FALSE.
[IosMobileApplicationManagementEnabled <Boolean?>]: When TRUE, inidicates that data from the Mobile Threat Defense partner can be used during Mobile Application Management (MAM) evaluations for iOS devices.
When FALSE, inidicates that data from the Mobile Threat Defense partner should not be used during Mobile Application Management (MAM) evaluations for iOS devices.
Only one partner per platform may be enabled for Mobile Application Management (MAM) evaluation.
Default value is FALSE.
[LastHeartbeatDateTime <DateTime?>]: DateTime of last Heartbeat recieved from the Mobile Threat Defense partner
[MicrosoftDefenderForEndpointAttachEnabled <Boolean?>]: When TRUE, inidicates that configuration profile management via Microsoft Defender for Endpoint is enabled.
When FALSE, inidicates that configuration profile management via Microsoft Defender for Endpoint is disabled.
Default value is FALSE.
[PartnerState <MobileThreatPartnerTenantState?>]: Partner state of this tenant.
[PartnerUnresponsivenessThresholdInDays <Int32?>]: Indicates the number of days without receiving a heartbeat from a Mobile Threat Defense partner before the partner is marked as unresponsive.
Intune will the ignore the data from this Mobile Threat Defense Partner for next compliance calculation.
[PartnerUnsupportedOSVersionBlocked <Boolean?>]: When TRUE, indicates that Intune will mark devices noncompliant on enabled platforms that do not meet the minimum version requirements of the Mobile Threat Defense partner.
When FALSE, indicates that Intune will not mark devices noncompliant on enabled platforms that do not meet the minimum version requirements of the Mobile Threat Defense partner.
Default value is FALSE.
[WindowsDeviceBlockedOnMissingPartnerData <Boolean?>]: When TRUE, indicates that Intune must receive data from the data sync partner prior to marking a device compliant for Windows.
When FALSE, indicates that Intune may mark a device compliant without receiving data from the data sync partner for Windows.
Default value is FALSE.
[WindowsEnabled <Boolean?>]: When TRUE, indicates that data from the Mobile Threat Defense partner will be used during compliance evaluations for Windows.
When FALSE, indicates that data from the Mobile Threat Defense partner will not be used during compliance evaluations for Windows.
Default value is FALSE.
INPUTOBJECT <IDeviceManagementAdministrationIdentity>: Identity Parameter
[AuditEventId <String>]: The unique identifier of auditEvent
[Category <String>]: Usage: category='{category}'
[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
[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
[UserPrincipalName <String>]: Alternate key of user