Edit

Get-AzArtifactSigningCertificateRoot

Module:
Az.ArtifactSigning Module

Retrieve Azure.ArtifactSigning Root Cert

Syntax

ByAccountProfileNameParameterSet (Default) 

Get-AzArtifactSigningCertificateRoot
    [-AccountName] <String>
    [-ProfileName] <String>
    [-EndpointUrl] <String>
    [-Destination] <String>
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

ByMetadataFileParameterSet 

Get-AzArtifactSigningCertificateRoot
    [-MetadataFilePath] <String>
    [-Destination] <String>
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

Description

The Get-AzArtifactSigningCertificateRoot cmdlet retrieves Azure ArtifactSigning Root Cert. Use this cmdlet to retrieve Azure ArtifactSigning Root Cert. There are two sets of parameters. One set uses AccountName, ProfileName, and EndpointUrl. Another set uses MetadataFilePath. Destination is the downloaded root cert file path, which includes the file name and extension .cer.

Examples

Example 1: Retrieve a root cert by account and profile name

Get-AzArtifactSigningCertificateRoot -AccountName 'contoso' -ProfileName 'contososigning' -EndpointUrl 'https://wus.artifactsigning.azure.net' -Destination 'c:\acs\certificateroot.cer'

Thumbprint                               Subject
----------                               -------
3A7B1F8C2E9D5A0B4F6E2C1D9F4B8A3E         CN=Microsoft Identity Verification Root Certificate Authority 2020, O=Microsoft

This command retrieves a root certificate that is currently in use for signing by the account and profile.

Example 2: Retrieve a root cert using the metadata file path configuration

Get-AzArtifactSigningCertificateRoot -MetadataFilePath 'c:\cisigning\metadata_input.json' -Destination 'c:\acs\certificateroot.cer'

Thumbprint                               Subject
----------                               -------
3A7B1F8C2E9D5A0B4F6E2C1D9F4B8A3E         CN=Microsoft Identity Verification Root Certificate Authority 2020, O=Microsoft

This command retrieves a root certificate that is currently in use for signing by the metadata configuration.

Parameters

-AccountName

Specifies Azure ArtifactSigning AccountName used to sign CI policy.

Parameter properties

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

Parameter sets

ByAccountProfileNameParameterSet
Position:0
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False

-DefaultProfile

The credentials, account, tenant, and subscription used for communication with Azure.

Parameter properties

Type:IAzureContextContainer
Default value:None
Supports wildcards:False
DontShow:False
Aliases:AzContext, AzureRmContext, AzureCredential

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Destination

Specifies the downloaded root cert file path.

Parameter properties

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

Parameter sets

(All)
Position:3
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False

-EndpointUrl

Specifies Azure ArtifactSigning Endpoint used to sign CI policy. It's an Url, format is https://xxx.artifactsigning.azure.net

Parameter properties

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

Parameter sets

ByAccountProfileNameParameterSet
Position:2
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False

-MetadataFilePath

Specifies Azure ArtifactSigning Metadata file path used to sign CI policy. It's a file path, and the metadata content is below. File content example: { "Endpoint": "https://xxx.artifactsigning.azure.net/", "ArtifactSigningAccountName": "acstest", "CertificateProfileName": "acstestCert1" }

Parameter properties

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

Parameter sets

ByMetadataFileParameterSet
Position:0
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False

-ProfileName

Specifies Azure ArtifactSigning ProfileName used to sign CI policy.

Parameter properties

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

Parameter sets

ByAccountProfileNameParameterSet
Position:1
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:True
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

Azure ArtifactSigning AccountName

Azure ArtifactSigning Profile Name

Azure ArtifactSigning Signing EndpointUrl

Azure ArtifactSigning UnSigned CI Policy File Path

Azure ArtifactSigning Signed CI Policy File Path Destination

String

Outputs

Signed CI Policy file