Split-SPScaleOutDatabase
Перемещает указанную часть разделов из одной базы данных горизонтального масштабирования в другую.
Синтаксис
NewDatabase
Split-SPScaleOutDatabase
-NewDatabaseName <String>
-SourceDatabase <SPDatabasePipeBind>
-SourceServiceApplication <SPServiceApplicationPipeBind>
[-AssignmentCollection <SPAssignmentCollection>]
[-Confirm]
[-MoveLowerHalf]
[-NewDatabaseCredentials <PSCredential>]
[-NewDatabaseFailoverServer <String>]
[-NewDatabaseServer <String>]
[-SourcePercentage <Int32>]
[-WhatIf]
[<CommonParameters>]
ExistingDatabase
Split-SPScaleOutDatabase
-SourceDatabase <SPDatabasePipeBind>
-SourceServiceApplication <SPServiceApplicationPipeBind>
-TargetDatabase <SPDatabasePipeBind>
[-AssignmentCollection <SPAssignmentCollection>]
[-Confirm]
[-MoveLowerHalf]
[-SourcePercentage <Int32>]
[-WhatIf]
[<CommonParameters>]
Описание
Этот командлет содержит несколько наборов параметров. Можно использовать параметры только из одного набора параметров. Совмещать параметры из разных наборов нельзя. Дополнительные сведения об использовании наборов параметров см. в статье Наборы параметров командлета.
Используйте Split-SPScaleOutDatabase командлет для перемещения определенного процента секций из исходной базы данных в существующую целевую базу данных или в новую базу данных, создаваемую с указанными параметрами.
Сведения о разрешениях и актуальную информацию о Windows PowerShell для продуктов SharePoint см. в сетевой документации о командлетах SharePoint Server.
Примеры
ПРИМЕР 1
$databases = Get-SPScaleOutDatabase -ServiceApplication $serviceApplication
$database = $databases[0]
Split-SPScaleOutDatabase -NewDatabaseName Database2 -NewDatabaseServer MyDatabaseServer -SourceDatabase $database -SourceServiceApplication $serviceApplication -SourcePercentage 30
Этот пример создает новую масштабируемую базу данных, Database2, на сервере базы данных MyDatabaseServer в указанном приложении-службе.
В примере также перемещается 30 % данных из верхней части диапазона данных в первой базе данных с горизонтальным масштабированием данного приложения-службы.
ПРИМЕР 2
$ssa = Get-SPEnterpriseSearchServiceApplication
$newReportingDb = "Search_AnalyticsReporting2"
$reportingDb = Get-SPScaleOutDatabase -SearchApplication $ssa
Split-SPServerScaleOutDatabase -SourceServiceApplication $ssa -SourceDatabase $reportingDb -NewDatabaseName $newReportingDb -SourcePercentage 33
В этом примере выполняется масштабирование базы данных Search Analytics и перемещение 33 % данных в новые базы данных.
Параметры
-AssignmentCollection
Применимо: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Позволяет корректно удалять объекты. При использовании объектов таких типов, как SPWeb или SPSite, возможен захват больших объемов памяти, и работа с такими объектами в скриптах Windows PowerShell требует точного управления памятью. С помощью объекта SPAssignment вы можете назначить объекты переменной и освободить память, удалив ненужные объекты. Объекты SPWeb, SPSite или SPSiteAdministration после использования удаляются автоматически, если коллекция назначения или параметр Global не применяются.
При использовании параметра Global все объекты содержатся в глобальном хранилище.
Если объекты не используются сразу или удаляются с помощью команды Stop-SPAssignment, может возникнуть нехватка памяти.
Свойства параметров
| Тип: | SPAssignmentCollection |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | True |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Confirm
Применимо: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Предлагает подтвердить выполнение команды.
Чтобы получить дополнительные сведения, введите следующую команду: get-help about_commonparameters
Свойства параметров
| Тип: | SwitchParameter |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | cf |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-MoveLowerHalf
Применимо: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Указывает, следует ли перемещать нижнюю или верхнюю границу диапазона данных из исходной базы данных горизонтального масштабирования. Если этот параметр не задан, по умолчанию выполняется перемещение верхней границы диапазона данных исходного базы данных горизонтального масштабирования.
Свойства параметров
| Тип: | SwitchParameter |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-NewDatabaseCredentials
Применимо: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Указывает учетные данные, используемые при создании масштабируемой базы данных. Эти учетные данные будут обладать правами владельца для созданной масштабируемой базы данных. Если значение не указано, по умолчанию будут использоваться учетные данные текущего пользователя.
Свойства параметров
| Тип: | PSCredential |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
NewDatabase
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-NewDatabaseFailoverServer
Применимо: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Указывает имя отказоустойчивого сервера создаваемой масштабируемой базы данных. Если значение параметра не указано, у масштабируемой базы данных не будет отказоустойчивого сервера.
Свойства параметров
| Тип: | String |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
NewDatabase
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-NewDatabaseName
Применимо: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Задает имя создаваемой масштабируемой базы данных.
Свойства параметров
| Тип: | String |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
NewDatabase
| Position: | Named |
| Обязательно: | True |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-NewDatabaseServer
Применимо: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Указывает имя сервера создаваемой масштабируемой базы данных. Если значение параметра не указано, используется сервер базы данных по умолчанию.
Свойства параметров
| Тип: | String |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
NewDatabase
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-SourceDatabase
Применимо: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Исходная масштабируемая база данных, из которой будут перемещаться данные.
Свойства параметров
| Тип: | SPDatabasePipeBind |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | True |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-SourcePercentage
Применимо: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Указывает часть данных в исходной масштабируемой базе данных, которую требуется переместить. Если значение параметра не указано, используется значение 50%.
Свойства параметров
| Тип: | Int32 |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-SourceServiceApplication
Применимо: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Приложение службы, в котором выполняется операция по перемещению данных.
Свойства параметров
| Тип: | SPServiceApplicationPipeBind |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | True |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-TargetDatabase
Применимо: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Конечная масштабируемая база данных, в которую будут перемещаться данные.
Свойства параметров
| Тип: | SPDatabasePipeBind |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
ExistingDatabase
| Position: | Named |
| Обязательно: | True |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-WhatIf
Применимо: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Отображает описание команды. При этом сама команда не выполняется.
Чтобы получить дополнительные сведения, введите следующую команду: get-help about_commonparameters
Свойства параметров
| Тип: | SwitchParameter |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | wi |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
CommonParameters
Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в статье about_CommonParameters.