Set-SPScaleOutDatabaseDataSubRange

  • Referenz
Modul:
SharePointServer
Gilt für::
SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Erstellt einen Unterbereich für eine angegebene Datenbank für die horizontale Skalierung.

Syntax

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

Beschreibung

Verwenden Sie das Set-SPScaleOutDatabaseDataSubRange Cmdlet, um einen Unterbereich mit den angegebenen Parametern für eine angegebene Datenbank mit horizontaler Skalierung oder eine Datenbank zu erstellen, die mit einer angegebenen Verbindungszeichenfolge verbunden wird. Ein Unterbereich ist eine Teilmenge eines Datenbereichs.

Informationen zu Berechtigungen sowie Aktuelles zu Windows PowerShell für SharePoint-Produkte finden Sie in der Onlinedokumentation unter SharePoint Server-Cmdlets.

Beispiele

------------------BEISPIEL-------------------

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

In diesem Beispiel wird für die erste Datenbank für die horizontale Skalierung der angegebenen Dienstanwendung ein schreibgeschützter Unterbereich erstellt, der beim Startpunkt des Datenbereichs beginnt und beim Endpunkt des Datenbereichs endet.

Parameter

-AssignmentCollection

Verwaltet Objekte zum Zweck der ordnungsgemäßen Beseitigung. Die Verwendung von Objekten wie beispielsweise SPWeb oder SPSite kann sehr viel Arbeitsspeicher erfordern, und für die Verwendung dieser Objekte in Windows PowerShell-Skripts muss der Arbeitsspeicher entsprechend verwaltet werden. Mit dem SPAssignment-Objekt können Sie einer Variablen Objekte zuweisen und die Objekte beseitigen, wenn sie nicht mehr benötigt werden, um Arbeitsspeicher freizugeben. Wenn die Objekte SPWeb, SPSite oder SPSiteAdministration verwendet werden, werden diese automatisch beseitigt, falls keine Zuweisungsauflistung oder kein Global-Parameter verwendet wird.

Wenn der Global-Parameter verwendet wird, sind alle Objekte im globalen Speicher enthalten. Es kann vorkommen, dass nicht genügend Arbeitsspeicher vorhanden ist, falls Objekte nicht sofort verwendet werden oder mit dem Befehl Stop-SPAssignment beseitigt werden.

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

-Confirm

Fordert Sie zum Bestätigen auf, bevor der Befehl ausgeführt wird. Um weitere Informationen zu erhalten, geben Sie den folgenden Befehl ein: 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 2013, SharePoint Server 2016, SharePoint Server 2019

-ConnectionString

Gibt die Verbindungszeichenfolge für die Datenbank für die horizontale Skalierung zum Erstellen des neuen Datenunterbereichs an.

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

-Database

Gibt die Datenbank für die horizontale Skalierung zum Erstellen des neuen Datenunterbereichs an.

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

-IgnoreSubRangePointOnBoundary

Gibt an, ob ohne Fehler abgeschlossen werden soll, wenn der Start- und Endpunkt des neuen Unterbereichs identisch sind. Wenn Sie diesen Parameter festlegen, werden keine Fehlermeldungen angezeigt.

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

-IsAzureDatabase

Specifies whether the database is hosted on SQL Azure.

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

-IsUpperSubRange

Gibt an, ob der Datenunterbereich oberhalb oder unterhalb von dem Datenbereich erstellt werden soll.

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

-Range

Gibt den erwarteten aktuellen Bereich der Datenbank für die horizontale Skalierung vor Ausführung dieses Vorgangs an.

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

-SubRangeMode

Gibt den Modus des zu erstellenden Datenunterbereichs an. Der Modus für den Datenunterbereich kann folgende Werte annehmen:

– NULL: Der Datenunterbereich auf der angegebenen Seite des Datenbereichs (oberhalb oder unterhalb) wird entfernt. --ReadOnly: Die Partitionen, die sich im neuen Datenunterbereich befinden, können gelesen, aber nicht geändert werden. --Changing - Die Partitionen, die sich innerhalb des neuen Datenunterbereichs befinden, können nicht gelesen oder geändert werden --Gelöscht: Die Partitionen, die sich innerhalb des neuen Datenunterbereichs befinden, können nicht gelesen oder geändert werden.

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

-SubRangePoint

Gibt den Start- oder den Endpunkt des zu erstellenden Datenunterbereichs an, je nach Definition durch die folgenden Kriterien:

- Den Startpunkt, wenn der Datenunterbereich auf der Seite oberhalb des Datenbereichs erstellt wird. - Den Endpunkt, wenn der Datenunterbereich auf der Seite unterhalb des Datenbereichs erstellt wird.

Der maximale Wert ist NULL.

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

-WhatIf

Zeigt eine Meldung an, die die Auswirkung des Befehls beschreibt, anstatt den Befehl auszuführen. Um weitere Informationen zu erhalten, geben Sie den folgenden Befehl ein: 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 2013, SharePoint Server 2016, SharePoint Server 2019