Freigeben über


Set-SPServerScaleOutDatabaseDataSubRange

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

Syntax

UnattachedDatabase

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

AttachedDatabase

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

Beschreibung

Das Cmdlet umfasst mehrere Parametersätze. Sie können nur Parameter aus einem der Parametersätze verwenden und können Parameter aus unterschiedlichen Parametersätzen nicht miteinander kombinieren. Weitere Informationen zur Verwendung von Parametersätzen finden Sie unter [Cmdlet Parameter Sets] (https://msdn.microsoft.com/library/dd878348(VS.85).aspx).

Beispiele

BEISPIEL

$databases = Get-SPServerScaleOutDatabase -ServiceApplication $serviceApplication
$database = $databases[0]
$state = Get-SPServerScaleOutDatabaseDataState -Database $database
Set-SPServerScaleOutDatabaseDataSubRange -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

Anwendbar: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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.

Hinweis: Wenn der Global-Parameter verwendet wird, sind alle Objekte im globalen Speicher enthalten. If objects are not immediately used, or disposed of by using the Stop-SPAssignment command, an out-of-memory scenario can occur.

Parametereigenschaften

Typ:SPAssignmentCollection
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Confirm

Anwendbar: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:vgl

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-ConnectionString

Anwendbar: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

UnattachedDatabase
Position:Named
Obligatorisch.:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Database

Anwendbar: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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

Parametereigenschaften

Typ:SPDatabasePipeBind
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

AttachedDatabase
Position:Named
Obligatorisch.:True
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-IgnoreSubRangePointOnBoundary

Anwendbar: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-IsAzureDatabase

Anwendbar: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Specifies whether the database is hosted on SQL Azure.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

UnattachedDatabase
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-IsUpperSubRange

Anwendbar: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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

Parametereigenschaften

Typ:Boolean
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Range

Anwendbar: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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

Parametereigenschaften

Typ:SPScaleOutDataRange
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-SubRangeMode

Anwendbar: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Parametereigenschaften

Typ:SPScaleOutDatabaseSubRangeMode
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-SubRangePoint

Anwendbar: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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.

Parametereigenschaften

Typ:

Byte[]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-WhatIf

Anwendbar: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Zeigt, was passieren würde, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:Wi

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen finden Sie unter about_CommonParameters.

Eingaben

Microsoft.SharePoint.PowerShell.SPDatabasePipeBind

Microsoft.SharePoint.PowerShell.SPAssignmentCollection

Ausgaben

System.Object