CA set version

Set-METSCASetVersion

Synopsis

Update a version.

Syntax

name-body (Default)

Set-METSCASetVersion -CASetName <String> -VersionID <Int32> -Body <Object> [-EdgeRCFile <String>]
 [-Section <String>] [-AccountSwitchKey <String>] [-ProgressAction <ActionPreference>] [<CommonParameters>]

name-dir

Set-METSCASetVersion -CASetName <String> -VersionID <Int32> -CertificatesDirectory <String>
 [-Comments <String>] [-AllowInsecureSha1] [-EdgeRCFile <String>] [-Section <String>]
 [-AccountSwitchKey <String>] [-ProgressAction <ActionPreference>] [<CommonParameters>]

name-file

Set-METSCASetVersion -CASetName <String> -VersionID <Int32> -CertificatesFile <String> [-Comments <String>]
 [-AllowInsecureSha1] [-EdgeRCFile <String>] [-Section <String>] [-AccountSwitchKey <String>]
 [-ProgressAction <ActionPreference>] [<CommonParameters>]

id-body

Set-METSCASetVersion -CASetID <Int32> -VersionID <Int32> -Body <Object> [-EdgeRCFile <String>]
 [-Section <String>] [-AccountSwitchKey <String>] [-ProgressAction <ActionPreference>] [<CommonParameters>]

id-dir

Set-METSCASetVersion -CASetID <Int32> -VersionID <Int32> -CertificatesDirectory <String> [-Comments <String>]
 [-AllowInsecureSha1] [-EdgeRCFile <String>] [-Section <String>] [-AccountSwitchKey <String>]
 [-ProgressAction <ActionPreference>] [<CommonParameters>]

id-file

Set-METSCASetVersion -CASetID <Int32> -VersionID <Int32> -CertificatesFile <String> [-Comments <String>]
 [-AllowInsecureSha1] [-EdgeRCFile <String>] [-Section <String>] [-AccountSwitchKey <String>]
 [-ProgressAction <ActionPreference>] [<CommonParameters>]

Description

Updates the settings for a specified version of your CA set.

You can specify the CA set by its name or ID. You need to provide the -VersionID to update, but if you pipe the results of Get-METSCASetVersion, this parameter will be read from the pipeline.

You can provide certificates either as a PSCustomObject or a single file containing 1 or more base-64-encoded certificates, or point to a directory containing 1 or more certificate files. You can also add Comments and allow SHA1 signatures with the -AllowInsecureSha1 switch parameter.

Parameters

-AccountSwitchKey

Account switch key, for use when you have access to multiple accounts and need to specify which one to use. Account switch keys can be found using Get-AccountSwitchKey.

Type: String
Parameter Sets: (All)
Aliases: None
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-AllowInsecureSha1

By default, the version's certificates need a signature algorithm of SHA-256 or better. Enabling this allows certificates with SHA-1 signatures.

Type: SwitchParameter
Parameter Sets: name-dir, name-file, id-dir, id-file
Aliases: None
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

-Body

Request body, either as a PSCustomObjector string. This parameter supports pipelining.

Type: Object
Parameter Sets: name-body, id-body
Aliases: None
Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False

-CASetID

ID of the CA set. You typically require this or the CASetName.

Type: Int32
Parameter Sets: id-body, id-dir, id-file
Aliases: None
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-CASetName

Name of the CA set. You typically require this or the CASetID.

Type: String
Parameter Sets: name-body, name-dir, name-file
Aliases: None
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-CertificatesDirectory

Folder to read individual certificates from. Files should contain base64-encoded certificates.

Type: String
Parameter Sets: name-dir, id-dir
Aliases: None
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-CertificatesFile

File containing one or more base64-encoded certificates.

Type: String
Parameter Sets: name-file, id-file
Aliases: None
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Comments

Any additional comments you can provide while creating or updating the CA set version.

Type: String
Parameter Sets: name-dir, name-file, id-dir, id-file
Aliases: None
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-EdgeRCFile

EdgeRC file to authenticate your command. Defaults to ~/.edgerc.

Type: String
Parameter Sets: (All)
Aliases: None
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Section

EdgeRC section to retrieve authentication credentials from. Defaults to default.

Type: String
Parameter Sets: (All)
Aliases: None
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-VersionID

Version identifier on which to perform the desired operation.

Type: Int32
Parameter Sets: (All)
Aliases: None
Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

Inputs

System.Int32

System.Object

Outputs