Revoke-MDMCertificateTemplate

2/9/2009

The Revoke-MDMCertificateTemplate cmdlet revokes the authorization of a certificate template so that certificates of the specified type created with this template will no longer function in the current MDM instance.

Syntax

Revoke-MDMCertificateTemplate [-Identity] <MDMCertificateTemplateId> -Type <MDMCertificateType> [-confirm] [-whatif] [<CommonParameters>]

Parameters

The following describes the Revoke-MDMCertificateTemplate cmdlet parameters.

  • Identity <MDMCertificateTemplateId>
    Specifies an MDM certificate template. The Identity parameter can be a certificate template name or object identifier (also known as an OID). If the value contains a space or other special characters, enclose the string in quotation marks.
  • Type <MDMCertificateType>
    Specifies the type of MDM certificate for which the template is no longer authorized. Valid types are WebServer, MobileDevice, or GCM.
  • WhatIf
    Informs you of what changes would be made if the action were to be performed (the cmdlet is not executed).
  • Confirm
    Prompts you for confirmation before the cmdlet executes.
  • CommonParameters
    This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, and -OutVariable. For more information, at the MDM Shell prompt, type get-help about_commonparameters.

Input Type

The Revoke-MDMCertificateTemplate cmdlet accepts a string through the pipeline that identifies an MDM certificate template, or an object that has the Identity property. The identity may be a certificate template name or object identifier.

Output Type

None

Examples

This Revoke-MDMCertificateTemplate command example revokes the authorization of the certificate template, "SCMDMGCM (Contoso)", so that it can no longer be used as a template for MDM GCM certificates in the current MDM instance.

C:\PS>Revoke-MDMCertificateTemplate -Identity "SCMDMGCM (Contoso)" -Type GCM

This Revoke-MDMCertificateTemplate command example revokes the authorization of the certificate template with the specified object identifier so that it can no longer be used as a template for MDM GCM certificates in the current MDM instance.

C:\PS>Revoke-MDMCertificateTemplate -Identity "0.0.0.0.9.0.000.00.9.9913859.993825.91034758.3215432.3702260.207.1.30" -Type GCM

Cmdlet Help

To view this information online, at the MDM Shell prompt, type:

get-help Revoke-MDMCertificateTemplate -detailed, or get-help Revoke-MDMCertificateTemplate -full

See Also

Reference

Grant-MDMCertificateTemplate
Get-MDMCertificateTemplate