[This command is not available in non-domain environments]
NAME
Remove-CATemplate
SYNOPSIS
Removes certificate templates from list that can be issued by a specified Certification Authority (CA).
SYNTAX
Remove-CATemplate -InputObject <CATemplate> -DisplayName <String[]> [<CommonParameters>]
Remove-CATemplate -InputObject <CATemplate> -Name <String[]> [<CommonParameters>]
Remove-CATemplate -InputObject <CATemplate> -Template <CertificateTemplate[]> [<CommonParameters>]
DESCRIPTION
Removes certificate templates from the list that can be issued by a specified Certification Authority (CA).
This command actually just prepares a new template list to be added to CA server. In order to write the new list to CA server use
Set-CATemplate command (see examples).
PARAMETERS
-InputObject <CATemplate>
Specifies the Certification Authority with assigned templates. This object can be retrieved by running
Get-CATemplate command.
| Required? |
true |
| Position? |
named |
| Default value |
|
| Accept pipeline input? |
true (ByValue, ByPropertyName) |
| Accept wildcard characters? |
false |
-DisplayName <String[]>
Specifies template (or templates) display name to remove from a specified CA server.
| Required? |
true |
| Position? |
named |
| Default value |
|
| Accept pipeline input? |
false |
| Accept wildcard characters? |
false |
-Name <String[]>
Specifies template (or templates) common name to remove from a specified CA server.
| Required? |
true |
| Position? |
named |
| Default value |
|
| Accept pipeline input? |
false |
| Accept wildcard characters? |
false |
-Template <CertificateTemplate[]>
Specifies template (or templates) object to remove from a specified CA server. Template object can be retrieved by running
Get-CertificateTemplate command.
| Required? |
true |
| 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 and OutVariable. For more information, type,
"get-help about_commonparameters".
INPUTS
PKI.CertificateAuthority.CATemplate
OUTPUTS
PKI.CertificateAuthority.CATemplate
NOTES
Author: Vadims Podans
Blog: http://en-us.sysadmins.lv
EXAMPLES
-------------- Example 1 --------------
C:\PS>Get-CertificationAuthority -Name "Company CA01" | Get-CATemplate | Remove-CATemplate -Name "Machine","WebServer" | Set-CATemplate
This command will remove Machine and 'WebServer' templates from 'Company CA01' CA server. CA server will unable to issue any certificates based on specified templates.
-------------- Example 2 --------------
C:\PS>Get-CertificationAuthority | Get-CATemplate | Remove-CATemplate -DisplayName "Domain Controller" | Set-CATemplate
This command will remove Domain Controller template from all Enterprise CAs in the forest.
-------------- Example 3 --------------
C:\PS>$Template = Get-CertificateTemplate -DisplayName "Key Recovery Agent"
C:\PS>Get-CertificationAuthority ca01.company.com | Get-CATemplate | Remove-CATemplate -Template $Template | Set-CATemplate
In this example first command retrieves Key Recovery Agent template object. In the second line specified template will be removed from CA server running on ca01.company.com server.
RELATED LINKS
Get-CertificationAuthority
Connect-CertificationAuthority
Get-CATemplate
Add-CATemplate
Set-CATemplate
Get-CertificateTemplate