Share via

Update-MgBetaSecurityPartnerSecurityScore

Module:
Microsoft.Graph.Beta.Security Module

Update the navigation property securityScore in security

Syntax

UpdateExpanded (Default) 

Update-MgBetaSecurityPartnerSecurityScore
    [-ResponseHeadersVariable <string>]
    [-AdditionalProperties <hashtable>]
    [-CurrentScore <float>]
    [-CustomerInsights <IMicrosoftGraphPartnerSecurityCustomerInsight[]>]
    [-History <IMicrosoftGraphPartnerSecurityScoreHistory[]>]
    [-Id <string>]
    [-LastRefreshDateTime <datetime>]
    [-MaxScore <float>]
    [-Requirements <IMicrosoftGraphPartnerSecurityRequirement[]>]
    [-UpdatedDateTime <datetime>]
    [-Break]
    [-Headers <IDictionary>]
    [-HttpPipelineAppend <SendAsyncStep[]>]
    [-HttpPipelinePrepend <SendAsyncStep[]>]
    [-Proxy <uri>]
    [-ProxyCredential <pscredential>]
    [-ProxyUseDefaultCredentials]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Update 

Update-MgBetaSecurityPartnerSecurityScore
    -BodyParameter <IMicrosoftGraphPartnerSecurityScore>
    [-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

-BodyParameter

partnerSecurityScore To construct, see NOTES section for BODYPARAMETER properties and create a hash table.

Parameter properties

Type:Microsoft.Graph.Beta.PowerShell.Models.IMicrosoftGraphPartnerSecurityScore
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

-CurrentScore

The current security score for the partner.

Parameter properties

Type:System.Single
Default value:0
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

-CustomerInsights

Contains customer-specific information for certain requirements. To construct, see NOTES section for CUSTOMERINSIGHTS properties and create a hash table.

Parameter properties

Type:

Microsoft.Graph.Beta.PowerShell.Models.IMicrosoftGraphPartnerSecurityCustomerInsight[]

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

-History

Contains a list of recent score changes. To construct, see NOTES section for HISTORY properties and create a hash table.

Parameter properties

Type:

Microsoft.Graph.Beta.PowerShell.Models.IMicrosoftGraphPartnerSecurityScoreHistory[]

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

-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

-LastRefreshDateTime

The last time the data was checked.

Parameter properties

Type:System.DateTime
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

-MaxScore

The maximum score possible.

Parameter properties

Type:System.Single
Default value:0
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

-Requirements

Contains the list of security requirements that make up the score. To construct, see NOTES section for REQUIREMENTS properties and create a hash table.

Parameter properties

Type:

Microsoft.Graph.Beta.PowerShell.Models.IMicrosoftGraphPartnerSecurityRequirement[]

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

-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

-UpdatedDateTime

The last time the security score or related properties changed.

Parameter properties

Type:System.DateTime
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.IMicrosoftGraphPartnerSecurityScore

{{ Fill in the Description }}

System.Collections.IDictionary

{{ Fill in the Description }}

Outputs

Microsoft.Graph.Beta.PowerShell.Models.IMicrosoftGraphPartnerSecurityScore

{{ 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.

BODYPARAMETER <IMicrosoftGraphPartnerSecurityScore>: partnerSecurityScore [(Any) <Object>]: This indicates any property can be added to this object. [Id <String>]: The unique identifier for an entity. Read-only. [CurrentScore <Single?>]: The current security score for the partner. [CustomerInsights <IMicrosoftGraphPartnerSecurityCustomerInsight[]>]: Contains customer-specific information for certain requirements. [Mfa <IMicrosoftGraphPartnerSecurityCustomerMfaInsight>]: customerMfaInsight [(Any) <Object>]: This indicates any property can be added to this object. [CompliantAdminsCount <Int64?>]: The number of admins that are compliant with the MFA requirements [CompliantNonAdminsCount <Int64?>]: The number of users that are compliant with the MFA requirements [LegacyPerUserMfaStatus <String>]: policyStatus [MfaConditionalAccessPolicyStatus <String>]: policyStatus [SecurityDefaultsStatus <String>]: policyStatus [TotalUsersCount <Int64?>]: The total number of users in the tenant [TenantId <String>]: The unique identifier for the customer. [History <IMicrosoftGraphPartnerSecurityScoreHistory[]>]: Contains a list of recent score changes. [Id <String>]: The unique identifier for an entity. Read-only. [CompliantRequirementsCount <Int64?>]: The number of compliant security requirements at the time. [CreatedDateTime <DateTime?>]: The date the history entry was created. [Score <Single?>]: The score recorded at the time. [TotalRequirementsCount <Int64?>]: The total number of requirements at the time. [LastRefreshDateTime <DateTime?>]: The last time the data was checked. [MaxScore <Single?>]: The maximum score possible. [Requirements <IMicrosoftGraphPartnerSecurityRequirement[]>]: Contains the list of security requirements that make up the score. [Id <String>]: The unique identifier for an entity. Read-only. [ActionUrl <String>]: The link to the site where the admin can take action on the requirement. [ComplianceStatus <String>]: complianceStatus [HelpUrl <String>]: The link to documentation for the requirement. [MaxScore <Int64?>]: The maximum score possible for the requirement. [RequirementType <String>]: securityRequirementType [Score <Int64?>]: The score received for this requirement. [State <String>]: securityRequirementState [UpdatedDateTime <DateTime?>]: The date the requirement properties were last updated. [UpdatedDateTime <DateTime?>]: The last time the security score or related properties changed.

CUSTOMERINSIGHTS <IMicrosoftGraphPartnerSecurityCustomerInsight[]>: Contains customer-specific information for certain requirements. [Mfa <IMicrosoftGraphPartnerSecurityCustomerMfaInsight>]: customerMfaInsight [(Any) <Object>]: This indicates any property can be added to this object. [CompliantAdminsCount <Int64?>]: The number of admins that are compliant with the MFA requirements [CompliantNonAdminsCount <Int64?>]: The number of users that are compliant with the MFA requirements [LegacyPerUserMfaStatus <String>]: policyStatus [MfaConditionalAccessPolicyStatus <String>]: policyStatus [SecurityDefaultsStatus <String>]: policyStatus [TotalUsersCount <Int64?>]: The total number of users in the tenant [TenantId <String>]: The unique identifier for the customer.

HISTORY <IMicrosoftGraphPartnerSecurityScoreHistory[]>: Contains a list of recent score changes. [Id <String>]: The unique identifier for an entity. Read-only. [CompliantRequirementsCount <Int64?>]: The number of compliant security requirements at the time. [CreatedDateTime <DateTime?>]: The date the history entry was created. [Score <Single?>]: The score recorded at the time. [TotalRequirementsCount <Int64?>]: The total number of requirements at the time.

REQUIREMENTS <IMicrosoftGraphPartnerSecurityRequirement[]>: Contains the list of security requirements that make up the score. [Id <String>]: The unique identifier for an entity. Read-only. [ActionUrl <String>]: The link to the site where the admin can take action on the requirement. [ComplianceStatus <String>]: complianceStatus [HelpUrl <String>]: The link to documentation for the requirement. [MaxScore <Int64?>]: The maximum score possible for the requirement. [RequirementType <String>]: securityRequirementType [Score <Int64?>]: The score received for this requirement. [State <String>]: securityRequirementState [UpdatedDateTime <DateTime?>]: The date the requirement properties were last updated.