Compartir a través de


Set-SPTrustedRootAuthority

Crea una nueva entidad de certificación raíz de confianza.

Sintaxis

ManualUpdateCertificateParameterSet

Set-SPTrustedRootAuthority
    [-Identity] <SPTrustedRootAuthorityPipeBind>
    [-AssignmentCollection <SPAssignmentCollection>]
    [-Certificate <X509Certificate2>]
    [-Confirm]
    [-WhatIf]
    [<CommonParameters>]

MetadataEndPointParameterSet

Set-SPTrustedRootAuthority
    [-Identity] <SPTrustedRootAuthorityPipeBind>
    [-AssignmentCollection <SPAssignmentCollection>]
    [-Confirm]
    [-MetadataEndPoint <Uri>]
    [-WhatIf]
    [<CommonParameters>]

Description

El Set-SPTrustedRootAuthority cmdlet crea una nueva entidad de certificación raíz de confianza. Si se usa un archivo de certificado, el certificado debe ser un certificado X509 sin claves privadas; de lo contrario, se produce una excepción.

Para obtener permisos y la información más reciente acerca de Windows PowerShell para Productos de SharePoint, vea la documentación en línea en Cmdlets de SharePoint Server.

Ejemplos

EJEMPLO

C:\PS>$cert = New-Object System.Security.Cryptography.X509Certificates.X509Certificate2
$cert.Import('C:\LiveIDSigningCert.pfx')
Get-SPTrustedRootAuthority -Identity "WFEFarm1" | Set-SPTrustedRootAuthority -Certificate $cert

En este ejemplo se actualiza el certificado de la entidad de certificación raíz de confianza WFEFarm1.

Parámetros

-AssignmentCollection

Aplicable: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Administra objetos para su correcta eliminación. El uso de objetos como SPWeb o SPSite puede requerir una gran cantidad de memoria y su uso en scripts de Windows PowerShell requiere una administración adecuada de la memoria. Mediante el uso del objeto SPAssignment se pueden asignar objetos a una variable y eliminar los objetos cuando ya no sean necesarios para liberar memoria. Cuando se usan los objetos SPWeb, SPSite o SPSiteAdministration, los objetos se eliminan automáticamente si no se usa una colección de asignaciones o el parámetro Global.

Cuando se usa el parámetro Global, todos los objetos se guardan en el almacén global. Si los objetos no se usan de forma inmediata o se eliminan mediante el comando Stop-SPAssignment, puede producirse un error de memoria insuficiente.

Propiedades del parámetro

Tipo:SPAssignmentCollection
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Certificate

Aplicable: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Especifica el certificado X.509 de la certificación raíz de confianza.

El tipo debe ser un nombre de certificado X.509 válido, como, por ejemplo, Certificate1.

Propiedades del parámetro

Tipo:X509Certificate2
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

ManualUpdateCertificateParameterSet
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Confirm

Aplicable: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Solicitará confirmación antes de ejecutar el cmdlet.

Propiedades del parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:cf

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Identity

Aplicable: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Especifica la entidad de certificación raíz de confianza que se va a actualizar.

El tipo debe ser un GUID válido con el formato 12345678-90ab-cdef-1234-567890bcdefgh, un nombre válido de entidad de certificacióni raíz de confianza (por ejemplo, WFEFarm1) o una instancia de un objeto SPTrustedRootAuthority válido.

Propiedades del parámetro

Tipo:SPTrustedRootAuthorityPipeBind
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:1
Mandatory:True
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-MetadataEndPoint

Aplicable: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

{{Fill MetadataEndPoint Description}}

Propiedades del parámetro

Tipo:Uri
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

MetadataEndPointParameterSet
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-WhatIf

Aplicable: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Muestra lo que ocurriría si se ejecuta el cmdlet. El cmdlet no se ejecuta.

Propiedades del parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:Wi

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

CommonParameters

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para más información, consulte about_CommonParameters.