Compartir a través de


Get-SPServiceContext

Devuelve un contexto de servicio.

Sintaxis

Site

Get-SPServiceContext
    [-Site] <SPSitePipeBind>
    [-AssignmentCollection <SPAssignmentCollection>]
    [<CommonParameters>]

SiteSubscription

Get-SPServiceContext
    -SiteSubscription <SPSiteSubscriptionPipeBind>
    [-AssignmentCollection <SPAssignmentCollection>]
    [<CommonParameters>]

Description

Este cmdlet contiene más de un conjunto de parámetros. Es posible que solo pueda usar parámetros procedentes de un conjunto de parámetros y no pueda combinar los parámetros de distintos conjuntos de parámetros. Para más información sobre cómo usar conjuntos de parámetros, vea Conjuntos de parámetros de cmdlets.

El cmdlet Get-SPServiceContext devuelve un contexto de servicio o una colección de contextos de servicio. Especifique el parámetro Site para devolver un contexto de servicio individual o especifique el parámetro SiteSubscription para devolver una colección de contextos de servicio.

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>$sitesub = Get-SPSiteSubscription https://my.contoso.com/

Get-SPServiceContext $sitesub

En este ejemplo se devuelve el contexto de servicio de un sitio en un entorno hospedado.

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

-Site

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

Devuelve el contexto de servicio solo para la aplicación web que contiene la colección de sitios especificada.

El tipo debe ser un GUID válido con el formato 12345678-90ab-cdef-1234-567890bcdefgh, una dirección URL válida con el formato https://server_name o una instancia de un objeto SPSite válido.

Propiedades del parámetro

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

Conjuntos de parámetros

Site
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

-SiteSubscription

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

Devuelve todos los contextos de servicio de todas las aplicaciones web en las que la suscripción de sitios especificada tiene colecciones de sitios.

El tipo debe ser un GUID válido con el formato 12345678-90ab-cdef-1234-567890bcdefgh, un nombre válido de suscripción de sitios (por ejemplo, SiteSubscriptionConfig1) o una instancia de un objeto SiteSubscription válido.

Propiedades del parámetro

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

Conjuntos de parámetros

SiteSubscription
Posición:Named
Mandatory:True
Valor de la canalización:True
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.