Set-RASCertificate

NAME

Set-RASCertificate

SYNOPSIS

Modifies the details of a Certificate.

SYNTAX

Set-RASCertificate [-Id] <uint> [-Description <string>] [-Enabled <bool>] [-IntermediateFile <string>] [-NewName <string>] [-PfxFile <string>] [-PfxPassword <SecureString>] [-PublicKeyFile <string>] [-Usage {None | Gateway | HALB}] [<CommonParameters>]

Set-RASCertificate [-InputObject] <Certificate> [-Description <string>] [-Enabled <bool>] [-IntermediateFile <string>] [-NewName <string>] [-PfxFile <string>] [-PfxPassword <SecureString>] [-PublicKeyFile <string>] [-Usage {None | Gateway | HALB}] [<CommonParameters>]

Set-RASCertificate [-Name] <string> [[-SiteId] <uint>] [-Description <string>] [-Enabled <bool>] [-IntermediateFile <string>] [-NewName <string>] [-PfxFile <string>] [-PfxPassword <SecureString>] [-PublicKeyFile <string>] [-Usage {None | Gateway | HALB}] [<CommonParameters>]

DESCRIPTION

Changes the basic details of a Certificate, sets the Public Key of a Requested Certificate or sets the Intermediate of an Imported Certificate.

PARAMETERS

-Name <string> The name of the target Certificate.

This must be the actual Certificate name used in the RAS farm.

        Required?                    true

        Position?                    0

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false

-SiteId <uint> Site ID in which to modify the specified Certificate.

If the parameter is omitted, the site ID of the Licensing Server will be used.

        Required?                    false

        Position?                    1

        Default value                0

        Accept pipeline input?       false

        Accept wildcard characters?  false

-Id <uint> The ID of the Certificate to modify. To obtain the ID, use the Get-Certificate cmdlet.

        Required?                    true

        Position?                    0

        Default value                0

        Accept pipeline input?       false

        Accept wildcard characters?  false

-InputObject <Certificate> The Certificate to modify.

To obtain an object of type Certificate representing a Certificate, use the Get-Certificate cmdlet.

        Required?                    true

        Position?                    0

        Default value                

        Accept pipeline input?       true (ByValue)

        Accept wildcard characters?  false

-NewName <string> The new name of the target Certificate.

        Required?                    false

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false

-Description <string> A user-defined Certificate description.

        Required?                    false

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false

-Usage <Certificate> Change the Usage for the Certificate.

Possible values: None, Gateway, HALB

        Required?                    false

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false

-Enabled <bool> Enable or disable the specified Certificate in a site.

        Required?                    false

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false

-PublicKeyFile <string> Public Key file name.

        Required?                    false

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false

-PfxFile <string> Certificate file name in pfx format.

        Required?                    false

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false

-PfxPassword <SecureString> The password of the pfx file specified in the PfxFile parameter.

        Required?                    false

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false

-IntermediateFile <string> Intermediate file name.

        Required?                    false

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false

<CommonParameters>

        This cmdlet supports the common parameters: Verbose, Debug,

        ErrorAction, ErrorVariable, WarningAction, WarningVariable,

        OutBuffer, PipelineVariable, and OutVariable. For more information, see 

        about_CommonParameters documentation. 

INPUTS

Certificate

OUTPUTS

-none-

EXAMPLES

---------- EXAMPLE 1 ----------

Set-RASCertificate -Name "Cert0" -NewName "Cert1"

Changes the name of Cert0, within the Licensing Site, to Cert1. ---------- EXAMPLE 2 ----------

Set-RASCertificate -Name "ImportedCert" -SiteId 2 -IntermediateFile "C:\intermediate.crt"

Modifies the Intermediate of the Imported Certificate (ImportedCert) within Site 2 to the contents of intermediate.crt ---------- EXAMPLE 3 ----------

Set-RASCertificate -Name "RequestedCert" -SiteId 3 -PublicKeyFile "C:\publicKey.crt"

Modifies the Public Key of the Requested Certificate (RequestedCert) within Site 3 to the public key within publicKey.crt

RELATED LINKS

• Get-RASCertificate
• New-RASCertificate
• Remove-RASCertificate
• Invoke-RASExportCertificate
• Invoke-RASCertificateCmd