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