Compartir a través de

Set-SPScaleOutDatabaseDataSubRange

Módulo:
SharePointServer module

Crea un subintervalo para una base de datos de escalado horizontal especificada.

Sintaxis

UnattachedDatabase 

Set-SPScaleOutDatabaseDataSubRange
    -ConnectionString <String>
    -IsUpperSubRange <Boolean>
    -Range <SPScaleOutDataRange>
    -SubRangeMode <SPScaleOutDatabaseSubRangeMode>
    [-AssignmentCollection <SPAssignmentCollection>]
    [-Confirm]
    [-IgnoreSubRangePointOnBoundary]
    [-IsAzureDatabase]
    [-SubRangePoint <Byte[]>]
    [-WhatIf]
    [<CommonParameters>]

AttachedDatabase 

Set-SPScaleOutDatabaseDataSubRange
    -Database <SPDatabasePipeBind>
    -IsUpperSubRange <Boolean>
    -Range <SPScaleOutDataRange>
    -SubRangeMode <SPScaleOutDatabaseSubRangeMode>
    [-AssignmentCollection <SPAssignmentCollection>]
    [-Confirm]
    [-IgnoreSubRangePointOnBoundary]
    [-SubRangePoint <Byte[]>]
    [-WhatIf]
    [<CommonParameters>]

Description

Use el Set-SPScaleOutDatabaseDataSubRange cmdlet para crear un subrange con los parámetros especificados para una base de datos de escalabilidad horizontal especificada o una base de datos que se conectará con un cadena de conexión especificado. Un subintervalo es un subconjunto de un intervalo de datos.

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>$databases = Get-SPScaleOutDatabase -ServiceApplication $serviceApplication

C:\PS>$database = $databases[0]

C:\PS>$state = Get-SPScaleOutDatabaseDataState -Database $database

Set-SPScaleOutDatabaseDataSubRange -Database $database -Range $state.Range -SubRangePoint $state.Range.RangeEnd -SubRangeMode ReadOnly -IsUpperSubRange $false

Este ejemplo crea un subintervalo de solo lectura que empieza en el punto inicial del intervalo de datos y finaliza en el punto final del intervalo de datos de la primera base de datos de escalado horizontal de la aplicación de servicio especificada.

Parámetros

-AssignmentCollection

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

-Confirm

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

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

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

-ConnectionString

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

Especifica la cadena de conexión de la base de datos de escalado horizontal para crear un nuevo subintervalo de datos.

Propiedades del parámetro

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

Conjuntos de parámetros

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

-Database

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

Especifica la base de datos de escalado horizontal para la que se creará un subintervalo de datos.

Propiedades del parámetro

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

Conjuntos de parámetros

AttachedDatabase
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

-IgnoreSubRangePointOnBoundary

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

Especifica si se completa sin errores si los puntos inicial y final del nuevo subrange son los mismos. Si se especifica este parámetro, no se mostrarán errores.

Propiedades del parámetro

Tipo:SwitchParameter
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:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-IsAzureDatabase

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

Especifica si la base de datos está almacenada en SQL Azure.

Propiedades del parámetro

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

Conjuntos de parámetros

UnattachedDatabase
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

-IsUpperSubRange

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

Especifica si se creará el subintervalo de datos en la parte superior o inferior del intervalo de datos.

Propiedades del parámetro

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

Conjuntos de parámetros

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

-Range

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

Especifica el intervalo actual esperado de la base de datos de escalado horizontal antes de esta acción.

Propiedades del parámetro

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

Conjuntos de parámetros

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

-SubRangeMode

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

Especifica el modo en que se creará el subintervalo de datos. Los valores del modo de subintervalo de datos son los siguientes:

-- NULL: se quitará el subintervalo de datos de la parte especificada (superior o inferior) del intervalo de datos. --ReadOnly: las particiones que se encuentran dentro del nuevo subrange de datos se pueden leer, pero no se pueden modificar. --Changing -The partitions which are inside the new data subrange cannot be read or modified --Deleted- The partitions which are inside the new data subrange cannot be read or modified

Propiedades del parámetro

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

Conjuntos de parámetros

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

-SubRangePoint

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

Especifica el punto inicial o final del subintervalo de datos que se creará según los criterios siguientes:

-- El punto inicial si el subintervalo de datos se crea en la parte superior del intervalo de datos. -- El punto final si el subintervalo de datos se crea en la parte inferior del intervalo de datos.

El valor máximo es NULL.

Propiedades del parámetro

Tipo:

Byte[]

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:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-WhatIf

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

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

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.