Share via

Set-CMCertificateRegistrationPoint

  • Referência
Módulo:
ConfigurationManager

Define uma função de ponto de registro de certificado em um servidor do sistema de site.

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>]

Description

O cmdlet Set-CMCertificateRegistrationPoint atualiza as configurações de uma função de ponto de registro de certificado em um servidor do sistema de site.

Observação

Execute Configuration Manager cmdlets da unidade do site Configuration Manager, por exemplo PS XYZ:\>. Para obter mais informações, confira introdução.

Exemplos

Exemplo 1: Definir uma função de ponto de registro de certificado usando o 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]

Esse comando obtém o objeto ponto de registro de certificado para o servidor do sistema de site chamado SiteServer01.Contoso.com e usa o operador de pipeline para passar o objeto para Set-CMCertificateRegistrationPoint. Set-CMCertificateRegistrationPoint adiciona o certificado chamado Cert.cer e remove o certificado chamado RootCA.cer usando a conta de usuário chamada Contoso\Administrator para se conectar ao banco de dados Configuration Manager.

Exemplo 2: Definir uma função de ponto de registro de certificado por nome

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]

Esse comando adiciona o certificado chamado RootCA.cer ao servidor do sistema de sites chamado SiteServer02.Contoso.com e remove o certificado chamado Cert.cer, usando a conta de usuário chamada Contoso\Admin1 para se conectar ao banco de dados Configuration Manager.

Parâmetros

-AddCertificate

Especifica, como uma tabela de hash, a URL do Serviço de Registro de Dispositivo de Rede e o certificado de AC raiz.

Type:Hashtable
Aliases:AddCertificates
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Solicita a confirmação antes de executar o cmdlet.

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

-ConnectionAccountUserName

Especifica a conta que conecta o ponto de registro de certificação ao banco de dados Configuration Manger.

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

-DisableWildcardHandling

Esse parâmetro trata caracteres curinga como valores de caractere literal. Você não pode combiná-lo com ForceWildcardHandling.

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

-ForceWildcardHandling

Esse parâmetro processa caracteres curinga e pode levar a um comportamento inesperado (não recomendado). Você não pode combiná-lo com DisableWildcardHandling.

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

-InputObject

Especifica um objeto de ponto de registro de certificação. Para obter um objeto de ponto de registro de certificado, use o cmdlet Get-CMCertificateRegistrationPoint.

Type:IResultObject
Aliases:CertificateRegistrationPoint
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-PassThru

Adicione esse parâmetro para retornar um objeto que representa o item com o qual você está trabalhando. Por padrão, esse cmdlet pode não gerar nenhuma saída.

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

-Port

Especifica o número da porta HTTPS usado pelo ponto de registro de certificado para se comunicar com o Serviço de Registro de Dispositivo de Rede.

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

-RemoveCertificate

Especifica uma matriz de URLs que correspondem a certificados correspondentes no objeto original.

Type:String[]
Aliases:RemoveCertificates, RemoveCertificateUrl, RemoveCertificateUrls
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SiteCode

Especifica o código do site do servidor do site Configuration Manager.

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

-SiteSystemServerName

Especifica o nome do servidor do sistema do site Configuration Manager.

Type:String
Aliases:Name, ServerName
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Mostrar o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

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

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Saídas

System.Object