Update-MgBetaInformationProtection
Update informationProtection
Note
To view the v1.0 release of this cmdlet, view Update-MgInformationProtection
Syntax
UpdateExpanded (Default)
Update-MgBetaInformationProtection
[-ResponseHeadersVariable <string>]
[-AdditionalProperties <hashtable>]
[-Bitlocker <IMicrosoftGraphBitlocker>]
[-DataLossPreventionPolicies <IMicrosoftGraphDataLossPreventionPolicy[]>]
[-Id <string>]
[-Policy <IMicrosoftGraphInformationProtectionPolicy>]
[-SensitivityLabels <IMicrosoftGraphSensitivityLabel[]>]
[-SensitivityPolicySettings <IMicrosoftGraphSensitivityPolicySettings>]
[-ThreatAssessmentRequests <IMicrosoftGraphThreatAssessmentRequest[]>]
[-Break]
[-Headers <IDictionary>]
[-HttpPipelineAppend <SendAsyncStep[]>]
[-HttpPipelinePrepend <SendAsyncStep[]>]
[-Proxy <uri>]
[-ProxyCredential <pscredential>]
[-ProxyUseDefaultCredentials]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Update
Update-MgBetaInformationProtection
-BodyParameter <IMicrosoftGraphInformationProtection>
[-ResponseHeadersVariable <string>]
[-Break]
[-Headers <IDictionary>]
[-HttpPipelineAppend <SendAsyncStep[]>]
[-HttpPipelinePrepend <SendAsyncStep[]>]
[-Proxy <uri>]
[-ProxyCredential <pscredential>]
[-ProxyUseDefaultCredentials]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Parameters
-AdditionalProperties
Additional Parameters
Parameter properties
| Type: | System.Collections.Hashtable |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
UpdateExpanded
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-Bitlocker
bitlocker To construct, see NOTES section for BITLOCKER properties and create a hash table.
Parameter properties
| Type: | Microsoft.Graph.Beta.PowerShell.Models.IMicrosoftGraphBitlocker |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
UpdateExpanded
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-BodyParameter
informationProtection To construct, see NOTES section for BODYPARAMETER properties and create a hash table.
Parameter properties
| Type: | Microsoft.Graph.Beta.PowerShell.Models.IMicrosoftGraphInformationProtection |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
Update
| Position: | Named |
| Mandatory: | True |
| Value from pipeline: | True |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-Break
Wait for .NET debugger to attach
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 |
-Confirm
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 |
-DataLossPreventionPolicies
To construct, see NOTES section for DATALOSSPREVENTIONPOLICIES properties and create a hash table.
Parameter properties
| Type: | Microsoft.Graph.Beta.PowerShell.Models.IMicrosoftGraphDataLossPreventionPolicy[] |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
UpdateExpanded
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-Headers
Optional headers that will be added to the request.
Parameter properties
| Type: | System.Collections.IDictionary |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | True |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-HttpPipelineAppend
SendAsync Pipeline Steps to be appended to the front of the pipeline
Parameter properties
| Type: | Microsoft.Graph.Beta.PowerShell.Runtime.SendAsyncStep[] |
| 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 |
-HttpPipelinePrepend
SendAsync Pipeline Steps to be prepended to the front of the pipeline
Parameter properties
| Type: | Microsoft.Graph.Beta.PowerShell.Runtime.SendAsyncStep[] |
| 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 |
-Id
The unique identifier for an entity. Read-only.
Parameter properties
| Type: | System.String |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
UpdateExpanded
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-Policy
informationProtectionPolicy To construct, see NOTES section for POLICY properties and create a hash table.
Parameter properties
| Type: | Microsoft.Graph.Beta.PowerShell.Models.IMicrosoftGraphInformationProtectionPolicy |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
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 |
-SensitivityLabels
To construct, see NOTES section for SENSITIVITYLABELS properties and create a hash table.
Parameter properties
| Type: | Microsoft.Graph.Beta.PowerShell.Models.IMicrosoftGraphSensitivityLabel[] |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
UpdateExpanded
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-SensitivityPolicySettings
sensitivityPolicySettings To construct, see NOTES section for SENSITIVITYPOLICYSETTINGS properties and create a hash table.
Parameter properties
| Type: | Microsoft.Graph.Beta.PowerShell.Models.IMicrosoftGraphSensitivityPolicySettings |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
UpdateExpanded
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-ThreatAssessmentRequests
To construct, see NOTES section for THREATASSESSMENTREQUESTS properties and create a hash table.
Parameter properties
| Type: | Microsoft.Graph.Beta.PowerShell.Models.IMicrosoftGraphThreatAssessmentRequest[] |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
UpdateExpanded
| 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 |
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.
Inputs
Microsoft.Graph.Beta.PowerShell.Models.IMicrosoftGraphInformationProtection
{{ Fill in the Description }}
System.Collections.IDictionary
{{ Fill in the Description }}
Outputs
Microsoft.Graph.Beta.PowerShell.Models.IMicrosoftGraphInformationProtection
{{ Fill in the Description }}
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.
BITLOCKER <IMicrosoftGraphBitlocker>: bitlocker
[(Any) <Object>]: This indicates any property can be added to this object.
[Id <String>]: The unique identifier for an entity.
Read-only.
[RecoveryKeys <IMicrosoftGraphBitlockerRecoveryKey[]>]: The recovery keys associated with the bitlocker entity.
[Id <String>]: The unique identifier for an entity.
Read-only.
[CreatedDateTime <DateTime?>]: The date and time when the key was originally backed up to Microsoft Entra ID.
[DeviceId <String>]: ID of the device the BitLocker key is originally backed up from.
[Key <String>]: The BitLocker recovery key.
[VolumeType <String>]: volumeType
BODYPARAMETER <IMicrosoftGraphInformationProtection>: informationProtection
[(Any) <Object>]: This indicates any property can be added to this object.
[Id <String>]: The unique identifier for an entity.
Read-only.
[Bitlocker <IMicrosoftGraphBitlocker>]: bitlocker
[(Any) <Object>]: This indicates any property can be added to this object.
[Id <String>]: The unique identifier for an entity.
Read-only.
[RecoveryKeys <IMicrosoftGraphBitlockerRecoveryKey[]>]: The recovery keys associated with the bitlocker entity.
[Id <String>]: The unique identifier for an entity.
Read-only.
[CreatedDateTime <DateTime?>]: The date and time when the key was originally backed up to Microsoft Entra ID.
[DeviceId <String>]: ID of the device the BitLocker key is originally backed up from.
[Key <String>]: The BitLocker recovery key.
[VolumeType <String>]: volumeType
[DataLossPreventionPolicies <IMicrosoftGraphDataLossPreventionPolicy[]>]:
[Id <String>]: The unique identifier for an entity.
Read-only.
[Name <String>]:
[Policy <IMicrosoftGraphInformationProtectionPolicy>]: informationProtectionPolicy
[(Any) <Object>]: This indicates any property can be added to this object.
[Id <String>]: The unique identifier for an entity.
Read-only.
[Labels <IMicrosoftGraphInformationProtectionLabel[]>]:
[Id <String>]: The unique identifier for an entity.
Read-only.
[Color <String>]: The color that the UI should display for the label, if configured.
[Description <String>]: The admin-defined description for the label.
[IsActive <Boolean?>]: Indicates whether the label is active or not.
Active labels should be hidden or disabled in UI.
[Name <String>]: The plaintext name of the label.
[Parent <IMicrosoftGraphParentLabelDetails>]: parentLabelDetails
[(Any) <Object>]: This indicates any property can be added to this object.
[Color <String>]: The color that the user interface should display for the label, if configured.
[Description <String>]: The admin-defined description for the label.
[Id <String>]: The label ID is a globally unique identifier (GUID).
[IsActive <Boolean?>]: Indicates whether the label is active or not.
Active labels should be hidden or disabled in user interfaces.
[Name <String>]: The plaintext name of the label.
[Parent <IMicrosoftGraphParentLabelDetails>]: parentLabelDetails
[Sensitivity <Int32?>]: The sensitivity value of the label, where lower is less sensitive.
[Tooltip <String>]: The tooltip that should be displayed for the label in a user interface.
[Sensitivity <Int32?>]: The sensitivity value of the label, where lower is less sensitive.
[Tooltip <String>]: The tooltip that should be displayed for the label in a UI.
[SensitivityLabels <IMicrosoftGraphSensitivityLabel[]>]:
[Id <String>]: The unique identifier for an entity.
Read-only.
[ActionSource <String>]: labelActionSource
[ApplicableTo <String>]: sensitivityLabelTarget
[ApplicationMode <String>]: applicationMode
[AutoTooltip <String>]:
[Color <String>]:
[Description <String>]:
[DisplayName <String>]:
[IsDefault <Boolean?>]:
[IsEnabled <Boolean?>]:
[IsEndpointProtectionEnabled <Boolean?>]:
[IsScopedToUser <Boolean?>]:
[Locale <String>]:
[Name <String>]:
[Priority <Int32?>]:
[Rights <IMicrosoftGraphUsageRightsIncluded>]: usageRightsIncluded
[(Any) <Object>]: This indicates any property can be added to this object.
[Id <String>]: The unique identifier for an entity.
Read-only.
[OwnerEmail <String>]: The email of owner label rights.
[UserEmail <String>]: The email of user with label user rights.
[Value <String>]: usageRights
[Sublabels <IMicrosoftGraphSensitivityLabel[]>]:
[ToolTip <String>]:
[SensitivityPolicySettings <IMicrosoftGraphSensitivityPolicySettings>]: sensitivityPolicySettings
[(Any) <Object>]: This indicates any property can be added to this object.
[Id <String>]: The unique identifier for an entity.
Read-only.
[ApplicableTo <String>]: sensitivityLabelTarget
[DowngradeSensitivityRequiresJustification <Boolean?>]:
[HelpWebUrl <String>]:
[IsMandatory <Boolean?>]:
[ThreatAssessmentRequests <IMicrosoftGraphThreatAssessmentRequest[]>]:
[Id <String>]: The unique identifier for an entity.
Read-only.
[Category <String>]: threatCategory
[ContentType <String>]: threatAssessmentContentType
[CreatedBy <IMicrosoftGraphIdentitySet>]: identitySet
[(Any) <Object>]: This indicates any property can be added to this object.
[Application <IMicrosoftGraphIdentity>]: identity
[(Any) <Object>]: This indicates any property can be added to this object.
[DisplayName <String>]: The display name of the identity.
This property is read-only.
[Id <String>]: The identifier of the identity.
This property is read-only.
[Device <IMicrosoftGraphIdentity>]: identity
[User <IMicrosoftGraphIdentity>]: identity
[CreatedDateTime <DateTime?>]: The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time.
For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z.
[ExpectedAssessment <String>]: threatExpectedAssessment
[RequestSource <String>]: threatAssessmentRequestSource
[Results <IMicrosoftGraphThreatAssessmentResult[]>]: A collection of threat assessment results.
Read-only.
By default, a GET /threatAssessmentRequests/{id} does not return this property unless you apply $expand on it.
[Id <String>]: The unique identifier for an entity.
Read-only.
[CreatedDateTime <DateTime?>]: The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time.
For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z.
[Message <String>]: The result message for each threat assessment.
[ResultType <String>]: threatAssessmentResultType
[Status <String>]: threatAssessmentStatus
DATALOSSPREVENTIONPOLICIES <IMicrosoftGraphDataLossPreventionPolicy[]>: . [Id <String>]: The unique identifier for an entity. Read-only. [Name <String>]:
POLICY <IMicrosoftGraphInformationProtectionPolicy>: informationProtectionPolicy
[(Any) <Object>]: This indicates any property can be added to this object.
[Id <String>]: The unique identifier for an entity.
Read-only.
[Labels <IMicrosoftGraphInformationProtectionLabel[]>]:
[Id <String>]: The unique identifier for an entity.
Read-only.
[Color <String>]: The color that the UI should display for the label, if configured.
[Description <String>]: The admin-defined description for the label.
[IsActive <Boolean?>]: Indicates whether the label is active or not.
Active labels should be hidden or disabled in UI.
[Name <String>]: The plaintext name of the label.
[Parent <IMicrosoftGraphParentLabelDetails>]: parentLabelDetails
[(Any) <Object>]: This indicates any property can be added to this object.
[Color <String>]: The color that the user interface should display for the label, if configured.
[Description <String>]: The admin-defined description for the label.
[Id <String>]: The label ID is a globally unique identifier (GUID).
[IsActive <Boolean?>]: Indicates whether the label is active or not.
Active labels should be hidden or disabled in user interfaces.
[Name <String>]: The plaintext name of the label.
[Parent <IMicrosoftGraphParentLabelDetails>]: parentLabelDetails
[Sensitivity <Int32?>]: The sensitivity value of the label, where lower is less sensitive.
[Tooltip <String>]: The tooltip that should be displayed for the label in a user interface.
[Sensitivity <Int32?>]: The sensitivity value of the label, where lower is less sensitive.
[Tooltip <String>]: The tooltip that should be displayed for the label in a UI.
SENSITIVITYLABELS <IMicrosoftGraphSensitivityLabel[]>: . [Id <String>]: The unique identifier for an entity. Read-only. [ActionSource <String>]: labelActionSource [ApplicableTo <String>]: sensitivityLabelTarget [ApplicationMode <String>]: applicationMode [AutoTooltip <String>]: [Color <String>]: [Description <String>]: [DisplayName <String>]: [IsDefault <Boolean?>]: [IsEnabled <Boolean?>]: [IsEndpointProtectionEnabled <Boolean?>]: [IsScopedToUser <Boolean?>]: [Locale <String>]: [Name <String>]: [Priority <Int32?>]: [Rights <IMicrosoftGraphUsageRightsIncluded>]: usageRightsIncluded [(Any) <Object>]: This indicates any property can be added to this object. [Id <String>]: The unique identifier for an entity. Read-only. [OwnerEmail <String>]: The email of owner label rights. [UserEmail <String>]: The email of user with label user rights. [Value <String>]: usageRights [Sublabels <IMicrosoftGraphSensitivityLabel[]>]: [ToolTip <String>]:
SENSITIVITYPOLICYSETTINGS <IMicrosoftGraphSensitivityPolicySettings>: sensitivityPolicySettings
[(Any) <Object>]: This indicates any property can be added to this object.
[Id <String>]: The unique identifier for an entity.
Read-only.
[ApplicableTo <String>]: sensitivityLabelTarget
[DowngradeSensitivityRequiresJustification <Boolean?>]:
[HelpWebUrl <String>]:
[IsMandatory <Boolean?>]:
THREATASSESSMENTREQUESTS <IMicrosoftGraphThreatAssessmentRequest[]>: . [Id <String>]: The unique identifier for an entity. Read-only. [Category <String>]: threatCategory [ContentType <String>]: threatAssessmentContentType [CreatedBy <IMicrosoftGraphIdentitySet>]: identitySet [(Any) <Object>]: This indicates any property can be added to this object. [Application <IMicrosoftGraphIdentity>]: identity [(Any) <Object>]: This indicates any property can be added to this object. [DisplayName <String>]: The display name of the identity. This property is read-only. [Id <String>]: The identifier of the identity. This property is read-only. [Device <IMicrosoftGraphIdentity>]: identity [User <IMicrosoftGraphIdentity>]: identity [CreatedDateTime <DateTime?>]: The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z. [ExpectedAssessment <String>]: threatExpectedAssessment [RequestSource <String>]: threatAssessmentRequestSource [Results <IMicrosoftGraphThreatAssessmentResult[]>]: A collection of threat assessment results. Read-only. By default, a GET /threatAssessmentRequests/{id} does not return this property unless you apply $expand on it. [Id <String>]: The unique identifier for an entity. Read-only. [CreatedDateTime <DateTime?>]: The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z. [Message <String>]: The result message for each threat assessment. [ResultType <String>]: threatAssessmentResultType [Status <String>]: threatAssessmentStatus