Skip to content

Latest commit

 

History

History
187 lines (140 loc) · 4.07 KB

Get-CMCertificate.md

File metadata and controls

187 lines (140 loc) · 4.07 KB

description: Gets a certificate. external help file: AdminUI.PS.dll-Help.xml Module Name: ConfigurationManager ms.date: 05/02/2019 schema: 2.0.0 title: Get-CMCertificate

Get-CMCertificate

SYNOPSIS

Gets a certificate.

SYNTAX

Get-CMCertificate [-CertificateType <CertificateType>] [-Fast] [-Id <String>] [-KeyType <KeyType>]
 [-Thumbprint <String>] [-DisableWildcardHandling] [-ForceWildcardHandling] [<CommonParameters>]

DESCRIPTION

The Get-CMCertificate cmdlet gets a certificate.

Note

Run Configuration Manager cmdlets from the Configuration Manager site drive, for example PS XYZ:\>. For more information, see getting started.

EXAMPLES

Example 1: Get all certificates

PS ABC:\> Get-CMCertificate

This command gets all certificates.

Example 2: Get a certificate by ID and thumbprint

PS ABC:\> Get-CMCertificate -Id "{4680a1bb-ae51-4bdf-8f27-979eb49e444e}" -Thumbprint e1c2fff14282b61f79f78fbfca6721f0517ab767 -CertificateType DistributionPoint -KeyType SelfSigned

This command gets the self-signed distribution point certificate with the specified ID and thumbprint.

PARAMETERS

-CertificateType

Specifies the certificate type. Valid values are:

  • BootMedia
  • DistributionPoint
  • IsvProxy
Type: CertificateType
Parameter Sets: (All)
Aliases:
Accepted values: BootMedia, DistributionPoint, IsvProxy

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

-DisableWildcardHandling

This parameter treats wildcard characters as literal character values. You can't combine it with ForceWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-Fast

Indicates that the cmdlet does not automatically refresh lazy properties.

Lazy properties contain values that are relatively inefficient to retrieve which can cause additional network traffic and decrease cmdlet performance. If lazy properties are not used, this parameter should be specified.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-ForceWildcardHandling

This parameter processes wildcard characters and may lead to unexpected behavior (not recommended). You can't combine it with DisableWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-Id

Specifies the ID of a certificate.

Type: String
Parameter Sets: (All)
Aliases: SmsId

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

-KeyType

Specifies the key type of the certificate. Valid values are:

  • SelfSigned
  • Issued
Type: KeyType
Parameter Sets: (All)
Aliases:
Accepted values: SelfSigned, Issued

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

-Thumbprint

Specifies the thumbprint of the certificate.

Type: String
Parameter Sets: (All)
Aliases:

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

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

INPUTS

None

OUTPUTS

IResultObject[]#SMS_Certificate

IResultObject#SMS_Certificate

NOTES

RELATED LINKS

Import-CMCertificate

Update-CMCertificate

Block-CMCertificate

Unblock-CMCertificate