Set-CMCertificateRegistrationPoint

  • Referência
Módulo:
ConfigurationManager

Define uma função de ponto de registo de certificados num servidor do sistema de sites.

Sintaxe

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 definições de uma função de ponto de registo de certificados num servidor do sistema de sites.

Observação

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

Exemplos

Exemplo 1: Definir uma função de ponto de registo de certificados com 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]

Este comando obtém o objeto de ponto de registo de certificados para o servidor do sistema de sites com o nome SiteServer01.Contoso.com e utiliza o operador de pipeline para transmitir o objeto para Set-CMCertificateRegistrationPoint. Set-CMCertificateRegistrationPoint adiciona o certificado com o nome Cert.cer e remove o certificado com o nome RootCA.cer ao utilizar a conta de utilizador denominada Contoso\Administrator para ligar à base de dados do Configuration Manager.

Exemplo 2: Definir uma função de ponto de registo de certificados 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]

Este comando adiciona o certificado com o nome RootCA.cer ao servidor do sistema de sites com o nome SiteServer02.Contoso.com e remove o certificado com o nome Cert.cer, utilizando a conta de utilizador denominada Contoso\Admin1 para ligar à base de dados do Configuration Manager.

Parâmetros

-AddCertificate

Especifica, como uma tabela hash, o URL do Serviço de Inscrição de Dispositivos de Rede e o certificado de AC de raiz.

Tipo:Hashtable
Aliases:AddCertificates
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Confirm

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

Tipo:SwitchParameter
Aliases:cf
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ConnectionAccountUserName

Especifica a conta que liga o ponto de registo de certificação à base de dados Configuration Manger.

Tipo:String
Aliases:UserName
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DisableWildcardHandling

Este parâmetro trata os carateres universais como valores de carateres literais. Não pode combiná-lo com ForceWildcardHandling.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ForceWildcardHandling

Este parâmetro processa carateres universais e pode levar a um comportamento inesperado (não recomendado). Não pode combiná-lo com DisableWildcardHandling.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-InputObject

Especifica um objeto de ponto de registo de certificação. Para obter um objeto de ponto de registo de certificados, utilize o cmdlet Get-CMCertificateRegistrationPoint.

Tipo:IResultObject
Aliases:CertificateRegistrationPoint
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-PassThru

Adicione este parâmetro para devolver um objeto que representa o item com o qual está a trabalhar. Por predefinição, este cmdlet pode não gerar qualquer saída.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Port

Especifica o número de porta HTTPS utilizado pelo ponto de registo de certificados para comunicar com o Serviço de Inscrição de Dispositivos de Rede.

Tipo:Int32
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-RemoveCertificate

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

Tipo:String[]
Aliases:RemoveCertificates, RemoveCertificateUrl, RemoveCertificateUrls
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-SiteCode

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

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-SiteSystemServerName

Especifica o nome do servidor do sistema de sites do Configuration Manager.

Tipo:String
Aliases:Name, ServerName
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-WhatIf

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

Tipo:SwitchParameter
Aliases:wi
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Saídas

System.Object