Freigeben über

Get-CMClientCertificatePfx

  • Referenz
Modul:
ConfigurationManager

Abrufen eines PFX-Clientzertifikats.

Syntax

Get-CMClientCertificatePfx
   [-Fast]
   [-InputObject <IResultObject>]
   [-Thumbprint <String>]
   [-UserName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

Beschreibung

Verwenden Sie dieses Cmdlet, um ein PFX-Zertifikat (Personal Information Exchange) für den Client abzurufen. Weitere Informationen finden Sie unter Einführung in Zertifikatprofile in Configuration Manager.

Hinweis

Führen Sie Configuration Manager-Cmdlets auf dem Configuration Manager-Standortlaufwerk aus, z. B PS XYZ:\>. . Weitere Informationen finden Sie unter Erste Schritte.

Beispiele

Beispiel 1: Abrufen eines PFX-Clientzertifikats

Dieser Befehl ruft das PFX-Clientzertifikat für den Benutzer namens jqpublic mit dem angegebenen Fingerabdruck ab.

Get-CMClientCertificatePfx -UserName (Get-CMUser -Name "contoso\jqpublic").SMSID -Thumbprint e1c2fff14282b61f79f78fbfca6721f0517ab767

Parameter

-DisableWildcardHandling

Dieser Parameter behandelt Wildcardzeichen als Literalzeichenwerte. Sie können es nicht mit ForceWildcardHandling kombinieren.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Fast

Fügen Sie diesen Parameter hinzu, um verzögerte Eigenschaften nicht automatisch zu aktualisieren. Verzögerte Eigenschaften enthalten Werte, die relativ ineffizient abgerufen werden können. Das Abrufen dieser Eigenschaften kann zusätzlichen Netzwerkdatenverkehr verursachen und die Cmdlet-Leistung beeinträchtigen.

Wenn Sie diesen Parameter nicht verwenden, zeigt das Cmdlet eine Warnung an. Um diese Warnung zu deaktivieren, legen Sie fest $CMPSSuppressFastNotUsedCheck = $true.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ForceWildcardHandling

Dieser Parameter verarbeitet Wildcardzeichen und kann zu unerwartetem Verhalten führen (nicht empfohlen). Sie können es nicht mit DisableWildcardHandling kombinieren.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-InputObject

Geben Sie ein PFX-Zertifikatprofilobjekt an. Verwenden Sie zum Abrufen dieses Objekts das Cmdlet Get-CMCertificateProfilePfx .

Typ:IResultObject
Aliase:CertificateProfilePfx
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Thumbprint

Geben Sie den Fingerabdruck des PFX-Clientzertifikats an. Wenn Sie diesen Parameter nicht angeben, werden alle Zertifikate für den Benutzer zurückgegeben.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-UserName

Geben Sie den Namen des Benutzers an, dessen PFX-Clientzertifikat Sie abrufen möchten. Um einen Wert für diesen Parameter abzurufen, können Sie den folgenden Befehl verwenden: (Get-CMUser -Name "contoso\jqpublic").SMSID.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Ausgaben

IResultObject

Hinweise

Weitere Informationen zu diesem Rückgabeobjekt und seinen Eigenschaften finden Sie unter SMS_ClientPfxCertificate WMI-Serverklasse.