Update-MgBetaInformationProtection
Update informationProtection
Note
To view the v1.0 release of this cmdlet, view Update-MgInformationProtection
Syntax
Update-MgBetaInformationProtection
[-ResponseHeadersVariable <String>]
[-AdditionalProperties <Hashtable>]
[-Bitlocker <IMicrosoftGraphBitlocker>]
[-DataLossPreventionPolicies <IMicrosoftGraphDataLossPreventionPolicy[]>]
[-Id <String>]
[-Policy <IMicrosoftGraphInformationProtectionPolicy>]
[-SensitivityLabels <IMicrosoftGraphSensitivityLabel[]>]
[-SensitivityPolicySettings <IMicrosoftGraphSensitivityPolicySettings>]
[-ThreatAssessmentRequests <IMicrosoftGraphThreatAssessmentRequest[]>]
[-Headers <IDictionary>]
[-ProgressAction <ActionPreference>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Update-MgBetaInformationProtection
-BodyParameter <IMicrosoftGraphInformationProtection>
[-ResponseHeadersVariable <String>]
[-Headers <IDictionary>]
[-ProgressAction <ActionPreference>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Description
Update informationProtection
Parameters
-AdditionalProperties
Additional Parameters
| Type: | Hashtable |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Bitlocker
bitlocker To construct, see NOTES section for BITLOCKER properties and create a hash table.
| Type: | IMicrosoftGraphBitlocker |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-BodyParameter
informationProtection To construct, see NOTES section for BODYPARAMETER properties and create a hash table.
| Type: | IMicrosoftGraphInformationProtection |
| 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 |
-DataLossPreventionPolicies
. To construct, see NOTES section for DATALOSSPREVENTIONPOLICIES properties and create a hash table.
| Type: | IMicrosoftGraphDataLossPreventionPolicy[] |
| 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 |
-Policy
informationProtectionPolicy To construct, see NOTES section for POLICY properties and create a hash table.
| Type: | IMicrosoftGraphInformationProtectionPolicy |
| Position: | Named |
| Default value: | None |
| 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 |
-SensitivityLabels
. To construct, see NOTES section for SENSITIVITYLABELS properties and create a hash table.
| Type: | IMicrosoftGraphSensitivityLabel[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SensitivityPolicySettings
sensitivityPolicySettings To construct, see NOTES section for SENSITIVITYPOLICYSETTINGS properties and create a hash table.
| Type: | IMicrosoftGraphSensitivityPolicySettings |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ThreatAssessmentRequests
. To construct, see NOTES section for THREATASSESSMENTREQUESTS properties and create a hash table.
| Type: | IMicrosoftGraphThreatAssessmentRequest[] |
| 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.IMicrosoftGraphInformationProtection
System.Collections.IDictionary
Outputs
Microsoft.Graph.Beta.PowerShell.Models.IMicrosoftGraphInformationProtection
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.[ApplicableTo <String>]: sensitivityLabelTarget[ApplicationMode <String>]: applicationMode[AssignedPolicies <IMicrosoftGraphLabelPolicy-[]>]:[Id <String>]:[Name <String>]:
[AutoLabeling <IMicrosoftGraphAutoLabeling>]: autoLabeling[(Any) <Object>]: This indicates any property can be added to this object.[Message <String>]:[SensitiveTypeIds <String-[]>]:
[Description <String>]:[DisplayName <String>]:[IsDefault <Boolean?>]:[IsEndpointProtectionEnabled <Boolean?>]:[LabelActions <IMicrosoftGraphLabelActionBase-[]>]:[Name <String>]:
[Name <String>]:[Priority <Int32?>]:[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. For drive items, the display name might not always be available or up to date. For example, if a user changes their display name the API might show the new value in a future response, but the items associated with the user don't show up as changed when using delta.[Id <String>]: Unique identifier for the identity or actor. For example, in the access reviews decisions API, this property might record the id of the principal, that is, the group, user, or application that's subject to review.
[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.[ApplicableTo <String>]: sensitivityLabelTarget[ApplicationMode <String>]: applicationMode[AssignedPolicies <IMicrosoftGraphLabelPolicy-[]>]:[Id <String>]:[Name <String>]:
[AutoLabeling <IMicrosoftGraphAutoLabeling>]: autoLabeling[(Any) <Object>]: This indicates any property can be added to this object.[Message <String>]:[SensitiveTypeIds <String-[]>]:
[Description <String>]:[DisplayName <String>]:[IsDefault <Boolean?>]:[IsEndpointProtectionEnabled <Boolean?>]:[LabelActions <IMicrosoftGraphLabelActionBase-[]>]:[Name <String>]:
[Name <String>]:[Priority <Int32?>]:[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. For drive items, the display name might not always be available or up to date. For example, if a user changes their display name the API might show the new value in a future response, but the items associated with the user don't show up as changed when using delta.[Id <String>]: Unique identifier for the identity or actor. For example, in the access reviews decisions API, this property might record the id of the principal, that is, the group, user, or application that's subject to review.
[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