Set-SPTrustedRootAuthority

  • Referencia
Módulo:
SharePointServer
Se aplica a:
SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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

Syntax

Set-SPTrustedRootAuthority
   [-Identity] <SPTrustedRootAuthorityPipeBind>
   [-AssignmentCollection <SPAssignmentCollection>]
   [-Certificate <X509Certificate2>]
   [-Confirm]
   [-WhatIf]
   [<CommonParameters>]
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

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.

Type:SPAssignmentCollection
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Certificate

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.

Type:X509Certificate2
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Confirm

Solicitará confirmación antes de ejecutar el cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Identity

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.

Type:SPTrustedRootAuthorityPipeBind
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-MetadataEndPoint

{{Fill MetadataEndPoint Description}}

Type:Uri
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019