Set-SPUsageService

Actualiza las propiedades de un servicio de uso.

Syntax

Set-SPUsageService
   [[-Identity] <SPUsageServicePipeBind>]
   [-AssignmentCollection <SPAssignmentCollection>]
   [-Confirm]
   [-LoggingEnabled <Boolean>]
   [-UsageLogCutTime <UInt32>]
   [-UsageLogLocation <String>]
   [-UsageLogMaxFileSizeKB <UInt32>]
   [-UsageLogMaxSpaceGB <UInt32>]
   [-WhatIf]
   [<CommonParameters>]

Description

El Set-SPUsageService cmdlet actualiza las propiedades de un servicio de uso. Si no se proporciona el parámetro Identity, el cmdlet aplica los cambios en el servicio de uso local.

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

Set-SPUsageService -LoggingEnabled $false

Set-SPUsageService -UsageLogLocation "D:\\testusagelogdir"


Set-SPUsageService -UsageLogCutTime 5

En los ejemplos se deshabilita el registro de uso, se cambia el directorio donde se almacenan los archivos de uso y se crea un nuevo archivo de registro de uso cada 5 minutos.

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

-Confirm

Le pide confirmación antes de ejecutar el comando. Para obtener más información, escriba el siguiente comando: get-help about_commonparameters

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 el servicio de uso que desea actualizar.

El tipo debe tener una de estas formas:

--Un GUID válido, con el formato 12345678-90ab-cdef-1234-567890bcdefgh --Un nombre válido de un servicio de uso (por ejemplo, UsageService1) --Una instancia de un objeto SPUsageService válido.

Type:SPUsageServicePipeBind
Position:1
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

-LoggingEnabled

Especifica que desea registrar los datos de uso en archivos de uso.

Type:Boolean
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

-UsageLogCutTime

Especifica el tiempo, en minutos, de los datos de uso que recopila el archivo de registro de uso. El valor predeterminado es 5 minutos.

El valor debe ser un entero entre 1 y 1440.

Type:UInt32
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

-UsageLogLocation

Especifica la ruta de acceso en todos los equipos de la granja donde se crean archivos de registro de uso.

El valor debe ser una ruta de acceso local válida con el siguiente formato:

  • C:\nombre_de_carpeta
Type:String
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

-UsageLogMaxFileSizeKB

Especifica el tamaño máximo de un único archivo de uso que se aplica a todos los proveedores de uso.

El valor mínimo es de 512 kilobytes (KB) y, el máximo, de 65536 KB.

Type:UInt32
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

-UsageLogMaxSpaceGB

Cantidad máxima de espacio (medida en gigabytes) permitida para los registros de uso. Aunque el parámetro está presente en versiones posteriores de SharePoint Server, solo se aplica a SharePoint Server 2010.

Type:UInt32
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

-WhatIf

Muestra un mensaje que describe el efecto del comando en lugar de ejecutar dicho comando. Para obtener más información, escriba el siguiente comando: get-help about_commonparameters

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