Prompts you for confirmation before running the cmdlet.
Parameter properties
Type:
System.Management.Automation.SwitchParameter
Supports wildcards:
False
DontShow:
False
Aliases:
cf
Parameter sets
(All)
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
-ControlledConfigurationEnabled
When TRUE indicates the Windows Defender controlled configuration feature is enabled, when FALSE indicates the Windows Defender controlled configuration feature is not enabled.
Defaults to setting on client device.
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
-DetectedMalwareState
Device malware list
To construct, see NOTES section for DETECTEDMALWARESTATE properties and create a hash table.
When TRUE indicates the device is a virtual machine, when FALSE indicates the device is not a virtual machine.
Defaults to setting on client device.
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
-LastFullScanDateTime
Last quick scan datetime
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
-LastFullScanSignatureVersion
Last full scan signature version
Parameter properties
Type:
System.String
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
-LastQuickScanDateTime
Last quick scan datetime
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
-LastQuickScanSignatureVersion
Last quick scan signature version
Parameter properties
Type:
System.String
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
-LastReportedDateTime
Last device health status reported time
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
-MalwareProtectionEnabled
When TRUE indicates anti malware is enabled when FALSE indicates anti malware is not enabled.
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
-ManagedDeviceId
The unique identifier of managedDevice
Parameter properties
Type:
System.String
Supports wildcards:
False
DontShow:
False
Parameter sets
UpdateExpanded
Position:
Named
Mandatory:
True
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
Update
Position:
Named
Mandatory:
True
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
-NetworkInspectionSystemEnabled
When TRUE indicates network inspection system enabled, when FALSE indicates network inspection system is not enabled.
Defaults to setting on client device.
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
-QuickScanOverdue
When TRUE indicates quick scan is overdue, when FALSE indicates quick scan is not overdue.
Defaults to setting on client device.
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
-RealTimeProtectionEnabled
When TRUE indicates real time protection is enabled, when FALSE indicates real time protection is not enabled.
Defaults to setting on client device.
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
-RebootRequired
When TRUE indicates reboot is required, when FALSE indicates when TRUE indicates reboot is not required.
Defaults to setting on client device.
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
-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
-SignatureUpdateOverdue
When TRUE indicates signature is out of date, when FALSE indicates signature is not out of date.
Defaults to setting on client device.
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
-SignatureVersion
Current malware definitions version
Parameter properties
Type:
System.String
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
-TamperProtectionEnabled
When TRUE indicates the Windows Defender tamper protection feature is enabled, when FALSE indicates the Windows Defender tamper protection feature is not enabled.
Defaults to setting on client device.
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
-UserId
The unique identifier of user
Parameter properties
Type:
System.String
Supports wildcards:
False
DontShow:
False
Parameter sets
UpdateExpanded
Position:
Named
Mandatory:
True
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
Update
Position:
Named
Mandatory:
True
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
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 <IMicrosoftGraphWindowsProtectionState>: Device protection status entity.
[(Any) <Object>]: This indicates any property can be added to this object.
[Id <String>]: The unique identifier for an entity.
Read-only.
[AntiMalwareVersion <String>]: Current anti malware version
[ControlledConfigurationEnabled <Boolean?>]: When TRUE indicates the Windows Defender controlled configuration feature is enabled, when FALSE indicates the Windows Defender controlled configuration feature is not enabled.
Defaults to setting on client device.
[DetectedMalwareState <IMicrosoftGraphWindowsDeviceMalwareState[]>]: Device malware list
[Id <String>]: The unique identifier for an entity.
Read-only.
[AdditionalInformationUrl <String>]: Information URL to learn more about the malware
[Category <WindowsMalwareCategory?>]: Malware category id
[DetectionCount <Int32?>]: Number of times the malware is detected
[DisplayName <String>]: Malware name
[ExecutionState <WindowsMalwareExecutionState?>]: Malware execution status
[InitialDetectionDateTime <DateTime?>]: Initial detection datetime of the malware
[LastStateChangeDateTime <DateTime?>]: The last time this particular threat was changed
[Severity <WindowsMalwareSeverity?>]: Malware severity
[State <WindowsMalwareState?>]: Malware current status
[ThreatState <WindowsMalwareThreatState?>]: Malware threat status
[DeviceState <WindowsDeviceHealthState?>]: Computer endpoint protection state
[EngineVersion <String>]: Current endpoint protection engine's version
[FullScanOverdue <Boolean?>]: When TRUE indicates full scan is overdue, when FALSE indicates full scan is not overdue.
Defaults to setting on client device.
[FullScanRequired <Boolean?>]: When TRUE indicates full scan is required, when FALSE indicates full scan is not required.
Defaults to setting on client device.
[IsVirtualMachine <Boolean?>]: When TRUE indicates the device is a virtual machine, when FALSE indicates the device is not a virtual machine.
Defaults to setting on client device.
[LastFullScanDateTime <DateTime?>]: Last quick scan datetime
[LastFullScanSignatureVersion <String>]: Last full scan signature version
[LastQuickScanDateTime <DateTime?>]: Last quick scan datetime
[LastQuickScanSignatureVersion <String>]: Last quick scan signature version
[LastReportedDateTime <DateTime?>]: Last device health status reported time
[MalwareProtectionEnabled <Boolean?>]: When TRUE indicates anti malware is enabled when FALSE indicates anti malware is not enabled.
[NetworkInspectionSystemEnabled <Boolean?>]: When TRUE indicates network inspection system enabled, when FALSE indicates network inspection system is not enabled.
Defaults to setting on client device.
[ProductStatus <WindowsDefenderProductStatus?>]: Product Status of Windows Defender
[QuickScanOverdue <Boolean?>]: When TRUE indicates quick scan is overdue, when FALSE indicates quick scan is not overdue.
Defaults to setting on client device.
[RealTimeProtectionEnabled <Boolean?>]: When TRUE indicates real time protection is enabled, when FALSE indicates real time protection is not enabled.
Defaults to setting on client device.
[RebootRequired <Boolean?>]: When TRUE indicates reboot is required, when FALSE indicates when TRUE indicates reboot is not required.
Defaults to setting on client device.
[SignatureUpdateOverdue <Boolean?>]: When TRUE indicates signature is out of date, when FALSE indicates signature is not out of date.
Defaults to setting on client device.
[SignatureVersion <String>]: Current malware definitions version
[TamperProtectionEnabled <Boolean?>]: When TRUE indicates the Windows Defender tamper protection feature is enabled, when FALSE indicates the Windows Defender tamper protection feature is not enabled.
Defaults to setting on client device.
DETECTEDMALWARESTATE <IMicrosoftGraphWindowsDeviceMalwareState[]>: Device malware list
[Id <String>]: The unique identifier for an entity.
Read-only.
[AdditionalInformationUrl <String>]: Information URL to learn more about the malware
[Category <WindowsMalwareCategory?>]: Malware category id
[DetectionCount <Int32?>]: Number of times the malware is detected
[DisplayName <String>]: Malware name
[ExecutionState <WindowsMalwareExecutionState?>]: Malware execution status
[InitialDetectionDateTime <DateTime?>]: Initial detection datetime of the malware
[LastStateChangeDateTime <DateTime?>]: The last time this particular threat was changed
[Severity <WindowsMalwareSeverity?>]: Malware severity
[State <WindowsMalwareState?>]: Malware current status
[ThreatState <WindowsMalwareThreatState?>]: Malware threat status
INPUTOBJECT <IDevicesCorporateManagementIdentity>: Identity Parameter
[AndroidManagedAppProtectionId <String>]: The unique identifier of androidManagedAppProtection
[DefaultManagedAppProtectionId <String>]: The unique identifier of defaultManagedAppProtection
[DeviceCompliancePolicyStateId <String>]: The unique identifier of deviceCompliancePolicyState
[DeviceConfigurationStateId <String>]: The unique identifier of deviceConfigurationState
[DeviceInstallStateId <String>]: The unique identifier of deviceInstallState
[DeviceLogCollectionResponseId <String>]: The unique identifier of deviceLogCollectionResponse
[DeviceManagementTroubleshootingEventId <String>]: The unique identifier of deviceManagementTroubleshootingEvent
[IosManagedAppProtectionId <String>]: The unique identifier of iosManagedAppProtection
[ManagedAppOperationId <String>]: The unique identifier of managedAppOperation
[ManagedAppPolicyId <String>]: The unique identifier of managedAppPolicy
[ManagedAppRegistrationId <String>]: The unique identifier of managedAppRegistration
[ManagedAppStatusId <String>]: The unique identifier of managedAppStatus
[ManagedDeviceId <String>]: The unique identifier of managedDevice
[ManagedDeviceMobileAppConfigurationAssignmentId <String>]: The unique identifier of managedDeviceMobileAppConfigurationAssignment
[ManagedDeviceMobileAppConfigurationDeviceStatusId <String>]: The unique identifier of managedDeviceMobileAppConfigurationDeviceStatus
[ManagedDeviceMobileAppConfigurationId <String>]: The unique identifier of managedDeviceMobileAppConfiguration
[ManagedDeviceMobileAppConfigurationUserStatusId <String>]: The unique identifier of managedDeviceMobileAppConfigurationUserStatus
[ManagedEBookAssignmentId <String>]: The unique identifier of managedEBookAssignment
[ManagedEBookId <String>]: The unique identifier of managedEBook
[ManagedMobileAppId <String>]: The unique identifier of managedMobileApp
[MdmWindowsInformationProtectionPolicyId <String>]: The unique identifier of mdmWindowsInformationProtectionPolicy
[MobileAppAssignmentId <String>]: The unique identifier of mobileAppAssignment
[MobileAppCategoryId <String>]: The unique identifier of mobileAppCategory
[MobileAppContentFileId <String>]: The unique identifier of mobileAppContentFile
[MobileAppContentId <String>]: The unique identifier of mobileAppContent
[MobileAppId <String>]: The unique identifier of mobileApp
[MobileAppRelationshipId <String>]: The unique identifier of mobileAppRelationship
[MobileContainedAppId <String>]: The unique identifier of mobileContainedApp
[TargetedManagedAppConfigurationId <String>]: The unique identifier of targetedManagedAppConfiguration
[TargetedManagedAppPolicyAssignmentId <String>]: The unique identifier of targetedManagedAppPolicyAssignment
[UserId <String>]: The unique identifier of user
[UserInstallStateSummaryId <String>]: The unique identifier of userInstallStateSummary
[VppTokenId <String>]: The unique identifier of vppToken
[WindowsDeviceMalwareStateId <String>]: The unique identifier of windowsDeviceMalwareState
[WindowsInformationProtectionAppLockerFileId <String>]: The unique identifier of windowsInformationProtectionAppLockerFile
[WindowsInformationProtectionPolicyId <String>]: The unique identifier of windowsInformationProtectionPolicy