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>]:
[HasProtection <Boolean?>]:
[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.
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. [ActionSource <String>]: labelActionSource [ApplicableTo <String>]: sensitivityLabelTarget [ApplicationMode <String>]: applicationMode [AutoTooltip <String>]: [Color <String>]: [Description <String>]: [DisplayName <String>]: [HasProtection <Boolean?>]: [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. 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