Edit

Share via


Add-HgsKeyProtectionAttestationSignerCertificate

Adds an attestation signer certificate for the trusted certificates for the Key Protection Service.

Syntax

Default (Default)

Add-HgsKeyProtectionAttestationSignerCertificate
    -Certificate <X509Certificate2>
    [-Force]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

The Add-HgsKeyProtectionAttestationSignerCertificate cmdlet adds the signer certificate of an attestation server to the list of certificates that the Key Protection Service trusts. The Key Protection Service uses attestation signer certificates to verify the signatures of health certificates. To modify the policy for an attestation signer certificate, use the Set-HgsKeyProtectionAttestationSignerCertificatePolicy cmdlet.

Examples

Example 1: Add a certificate

PS C:\> Add-HgsKeyProtectionAttestationSignerCertificate -Certificate $Certificate

This command adds the certificate stored in the $Certificate variable to the trusted attestation signer certificates.

Parameters

-Certificate

Specifies an X509Certificate2 certificate. This cmdlet adds the certificate that this parameter specifies to the attestation signer certificates that the Key Protection Service trusts. Specify a variable that stores an X509Certificate2 object or an expression that gets the certificate.

Parameter properties

Type:X509Certificate2
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:True
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:SwitchParameter
Default value:False
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

-Force

Forces the command to run without asking for user confirmation.

Parameter properties

Type:SwitchParameter
Default value:None
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

-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

Parameter properties

Type:SwitchParameter
Default value:False
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

None

You cannot pipe input to this cmdlet.

Outputs

None

This cmdlet does not generate any output.