Freigeben über


Set-CMCertificateRegistrationPoint

Legt eine Zertifikatregistrierungspunktrolle auf einem Standortsystemserver fest.

Syntax

Set-CMCertificateRegistrationPoint
   [-AddCertificate <Hashtable>]
   [-ConnectionAccountUserName <String>]
   -InputObject <IResultObject>
   [-PassThru]
   [-Port <Int32>]
   [-RemoveCertificate <String[]>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMCertificateRegistrationPoint
   [-AddCertificate <Hashtable>]
   [-ConnectionAccountUserName <String>]
   [-PassThru]
   [-Port <Int32>]
   [-RemoveCertificate <String[]>]
   [-SiteCode <String>]
   [-SiteSystemServerName] <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Beschreibung

Das Cmdlet Set-CMCertificateRegistrationPoint aktualisiert die Einstellungen einer Zertifikatregistrierungspunktrolle auf einem Standortsystemserver.

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: Festlegen einer Zertifikatregistrierungspunktrolle mithilfe der Pipeline

PS XYZ:\> Get-CMCertificateRegistrationPoint -SiteSystemServerName "SiteServer01.Contoso.com" | Set-CMCertificateRegistrationPoint  -AddCertificate @{"https://ndes2.fabrikam.com/certsrv/mscep/mscep.dll" ="\\Server\ShareFolder\Cert.cer"} -ConnectionAccountUserName (Get-CMUser -Name Contoso\Administrator).UserName -RemoveCertificate @{"https://ndes1.fabrikam.com/certsrv/mscep/mscep.dll"="\\Server\ShareFolder\RootCA.cer"}.Keys[0]

Dieser Befehl ruft das Zertifikatregistrierungspunktobjekt für den Standortsystemserver namens SiteServer01.Contoso.com ab und verwendet den Pipelineoperator, um das Objekt an Set-CMCertificateRegistrationPoint zu übergeben. Set-CMCertificateRegistrationPoint fügt das Zertifikat namens Cert.cer hinzu und entfernt das Zertifikat mit dem Namen RootCA.cer, indem das Benutzerkonto Contoso\Administrator verwendet wird, um eine Verbindung mit der Configuration Manager-Datenbank herzustellen.

Beispiel 2: Festlegen einer Zertifikatregistrierungspunktrolle anhand des Namens

PS XYZ:\> Set-CMCertificateRegistrationPoint -SiteSystemServerName "SiteServer02.Contoso.com" -AddCertificate @{"https://ndes2.fabrikam.com/certsrv/mscep/mscep.dll"="\\Server\ShareFolder\RootCA.cer"} -ConnectionAccountUserName (Get-CMUser -Name Contoso\Admin1).UserName -RemoveCertificate @{"https://ndes1.fabrikam.com/certsrv/mscep/mscep.dll" ="\\Server\ShareFolder\Cert.cer"}.Keys[0]

Dieser Befehl fügt das Zertifikat namens RootCA.cer dem Standortsystemserver namens SiteServer02.Contoso.com hinzu und entfernt das Zertifikat namens Cert.cer, indem das Benutzerkonto Contoso\Admin1 verwendet wird, um eine Verbindung mit der Configuration Manager-Datenbank herzustellen.

Parameter

-AddCertificate

Gibt als Hashtabelle die URL für den Registrierungsdienst für Netzwerkgeräte und das Zertifikat der Stammzertifizierungsstelle an.

Typ:Hashtable
Aliase:AddCertificates
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Confirm

Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.

Typ:SwitchParameter
Aliase:cf
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ConnectionAccountUserName

Gibt das Konto an, das den Zertifizierungsregistrierungspunkt mit der Configuration Manager-Datenbank verbindet.

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

-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

-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

Gibt ein Registrierungspunktobjekt für die Zertifizierung an. Verwenden Sie das Cmdlet Get-CMCertificateRegistrationPoint, um ein Zertifikatregistrierungspunktobjekt abzurufen.

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

-PassThru

Fügen Sie diesen Parameter hinzu, um ein Objekt zurückzugeben, das das Element darstellt, mit dem Sie arbeiten. Standardmäßig generiert dieses Cmdlet möglicherweise keine Ausgabe.

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

-Port

Gibt die HTTPS-Portnummer an, die vom Zertifikatregistrierungspunkt für die Kommunikation mit dem Registrierungsdienst für Netzwerkgeräte verwendet wird.

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

-RemoveCertificate

Gibt ein Array von URLs an, die den entsprechenden Zertifikaten im ursprünglichen Objekt entsprechen.

Typ:String[]
Aliase:RemoveCertificates, RemoveCertificateUrl, RemoveCertificateUrls
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-SiteCode

Gibt den Standortcode des Configuration Manager-Standortservers an.

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

-SiteSystemServerName

Gibt den Namen des Configuration Manager-Standortsystemservers an.

Typ:String
Aliase:Name, ServerName
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-WhatIf

Zeigt, was passieren würde, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Typ:SwitchParameter
Aliase:wi
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Ausgaben

System.Object