Share via

Remove-CrmCertificate

  • Reference
Module:
Microsoft.Crm.PowerShell

Removes the specified certificate from the Dynamics 365 deployment.

Syntax

Remove-CrmCertificate
      [-Id] <Guid>
      [-Timeout <Int32>]
      [-Diag]
      [-Credential <PSCredential>]
      [-DwsServerUrl <String>]
      [-WhatIf]
      [-Confirm]
Remove-CrmCertificate
      [-Certificate] <Certificate>
      [-Timeout <Int32>]
      [-Diag]
      [-Credential <PSCredential>]
      [-DwsServerUrl <String>]
      [-WhatIf]
      [-Confirm]

Description

The Remove-CrmCertificate cmdlet removes the specified certificate from the Dynamics 365 deployment.

Examples

Example 1

PS C:\> Remove-CrmCertificate -Id d4eb76bf-2e6f-e211-bb1c-00155da94203

Removes the certificate that has the specified Id.

Example 2

PS C:\> Remove-CrmCertificate -Certificate $certToRemove

Removes the certificate described by the certToRemove object.

Parameters

-Certificate

The Microsoft.Xrm.Sdk.Deployment.Certificate object contains information about the certificate that is being addressed, created, or removed.

Type:Certificate
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Confirm

Prompts you for confirmation before running the cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Credential

Expects a variable that contains the user credentials used for signing in to Dynamics 365 on-premises organization. To establish this variable, run the PowerShell command $Cred = Get-Credential.

Type:PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Diag

Turns on stack traces for error reports returned from Dynamics 365 service calls. Enabling this emits a detailed error message, including a stack trace, when an error is encountered by the Dynamics 365 PowerShell command.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-DwsServerUrl

The URL of the Deployment Web Service. This should be in the format: https://, for example, https://contoso.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Id

Specifies the ID of the certificate object (Microsoft.Xrm.Sdk.Deployment.Certificate) being addressed.

Type:Guid
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Timeout

For internal user only.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Inputs

System.Guid

Microsoft.Xrm.Sdk.Deployment.Certificate System.Int32 System.Management.Automation.SwitchParameter System.Management.Automation.PSCredential System.String

Outputs

System.Object