Поделиться через

New-SPConfigurationDatabase

  • Ссылка
Модуль:
sharepoint-server
Применяется к:
SharePoint Server Subscription Edition

Создает базу данных конфигурации.

Синтаксис

New-SPConfigurationDatabase
   [-DatabaseName] <String>
   [-DatabaseServer] <String>
   [[-DirectoryDomain] <String>]
   [[-DirectoryOrganizationUnit] <String>]
   [[-AdministrationContentDatabaseName] <String>]
   [[-DatabaseCredentials] <PSCredential>]
   [-FarmCredentials] <PSCredential>
   [-Passphrase] <SecureString>
   [-SkipRegisterAsDistributedCacheHost]
   [-AssignmentCollection <SPAssignmentCollection>]
   [-DatabaseFailOverServer <String>]
   [-LocalServerRole <SPServerRole>]
   [-ServerRoleOptional]
   [-DatabaseConnectionEncryption <SqlConnectionEncryptOption>]
   [-DatabaseServerCertificateHostName <String>]
   [<CommonParameters>]

Описание

Командлет New-SPConfigurationDatabase создает базу данных конфигурации на указанном сервере баз данных. Эта база данных является центральной для новой фермы SharePoint.

Сведения о разрешениях и актуальную информацию о Windows PowerShell для продуктов SharePoint см. в сетевой документации о командлетах SharePoint Server.

Примеры

------------------ПРИМЕР 1-----------------------

New-SPConfigurationDatabase -DatabaseName "SharePointConfigDB1" -DatabaseServer "SQL-01" -Passphrase (ConvertTo-SecureString "MyPassword" -AsPlainText -force) -FarmCredentials (Get-Credential)

В данном примере пользователю предлагается ввести учетные данные для учетной записи администратора фермы по умолчанию.

--------------------------ПРИМЕР 2------------------------

New-SPConfigurationDatabase -DatabaseName "SharePointConfigDB1" -DatabaseServer "SQL-01" -Passphrase (ConvertTo-SecureString "MyPassword" -AsPlainText -force) -FarmCredentials (Get-Credential) -SkipRegisterAsDistributedCacheHost

В этом примере пользователю предлагается ввести учетные данные пользователя для учетной записи администратора фермы по умолчанию и пропускается регистрация сервера в качестве узла распределенного кэша. Применимо только к SharePoint Server 2013 и SharePoint Server 2016, SharePoint Server 2019.

------------------ПРИМЕР 3-----------------------

New-SPConfigurationDatabase -DatabaseName "SharePointConfigDB1" -DatabaseServer "SQL-01" -Passphrase (ConvertTo-SecureString "MyPassword" -AsPlainText -force) -FarmCredentials (Get-Credential) -LocalServerRole Custom

В этом примере пользователю предлагается указать учетные данные пользователя для учетной записи администратора фермы по умолчанию и задать для роли сервера значение Настраиваемое. Применяется только к SharePoint Server 2016, SharePoint Server 2019.

Параметры

-AdministrationContentDatabaseName

Задает имя базы данных контента центра администрирования для новой фермы. Если имя не указано, используется имя по умолчанию.

Тип:String
Position:5
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False
Применяется к:SharePoint Server Subscription Edition

-AssignmentCollection

Позволяет корректно удалять объекты. При использовании объектов таких типов, как SPWeb или SPSite, возможен захват больших объемов памяти, и работа с такими объектами в скриптах Windows PowerShell требует точного управления памятью. С помощью объекта SPAssignment вы можете назначить объекты переменной и освободить память, удалив ненужные объекты. Объекты SPWeb, SPSite или SPSiteAdministration после использования удаляются автоматически, если коллекция назначения или параметр Global не применяются.

Если применяется параметр Global, то все объекты размещаются в глобальной области памяти. Если объекты не используются сразу же или не удаляются командой Stop-SPAssignment, может возникнуть ситуация нехватки памяти.

Тип:SPAssignmentCollection
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False
Применяется к:SharePoint Server Subscription Edition

-DatabaseConnectionEncryption

Указывает, используется ли шифрование TLS для подключения между SharePoint и базой данных. Обязательно требуется шифрование TLS. Если не удается согласовать шифрование TLS, подключение завершится ошибкой. (Необязательно) позволяет использовать шифрование TLS. Если для сервера базы данных требуется шифрование TLS, будет использоваться шифрование TLS. В противном случае шифрование TLS не будет использоваться. Для строгого шифрования требуется использовать шифрование TLS с TDS 8.0, которая является самой надежной конфигурацией шифрования. Если не удается согласовать шифрование TLS с помощью TDS 8.0, подключение завершится ошибкой. Базы данных, подключенные к SharePoint до установки обновления компонентов версии 24H2, по умолчанию — необязательное шифрование. Если этот параметр не указан при подключении новой базы данных к SharePoint после установки обновления компонентов версии 24H2, по умолчанию используется значение Обязательно.

Тип:SqlConnectionEncryptOption
Position:Named
Default value:Mandatory
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False
Применяется к:SharePoint Server Subscription Edition

-DatabaseCredentials

Задает объект учетных данных для пользователя базы данных. Этот параметр следует использовать, если применяется проверка подлинности SQL Server. Если учетные данные базы данных не указаны, используется проверка подлинности Windows.

Тип:PSCredential
Position:6
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False
Применяется к:SharePoint Server Subscription Edition

-DatabaseFailOverServer

Указывает сервер-партнер SQL Server Database Mirror для базы данных конфигурации и центра администрирования.

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False
Применяется к:SharePoint Server Subscription Edition

-DatabaseName

Задает имя новой базы данных конфигурации.

Тип:String
Position:1
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False
Применяется к:SharePoint Server Subscription Edition

-DatabaseServer

Указывает сервер баз данных, на котором необходимо создать базу данных. Если значение не указано, используется значение по умолчанию.

Тип:String
Position:2
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False
Применяется к:SharePoint Server Subscription Edition

-DatabaseServerCertificateHostName

Задает имя узла, используемое при проверке сертификата сервера для подключения.

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False
Применяется к:SharePoint Server Subscription Edition

-DirectoryDomain

Задает домен каталогов для новой фермы. Если значение не указано, используется домен, к которому относится локальный компьютер.

Тип:String
Position:3
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False
Применяется к:SharePoint Server Subscription Edition

-DirectoryOrganizationUnit

Определяет подразделение каталога для новой базы данных конфигурации. Если значение не указано, используется подразделение, к которому относится локальный компьютер.

Тип:String
Position:4
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False
Применяется к:SharePoint Server Subscription Edition

-FarmCredentials

Задает учетные данные для учетной записи администратора фермы.

Тип:PSCredential
Position:7
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False
Применяется к:SharePoint Server Subscription Edition

-LocalServerRole

Указывает роль сервера. Допустимые параметры для всех версий SharePoint Server 2016, SharePoint Server 2019: Custom, SingleServerFarm, , ApplicationWebFrontEnd, DistributedCache, , .Search

С добавлением пакета дополнительных компонентов 1 новые параметры включают: ApplicationWithSearch, WebFrontEndWithDistributedCache

Тип:SPServerRole
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False
Применяется к:SharePoint Server Subscription Edition

-Passphrase

Задает безопасную парольную фразу для новой фермы. Эта парольная фраза используется для подключения других компьютеров к ферме.

Тип:SecureString
Position:8
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False
Применяется к:SharePoint Server Subscription Edition

-ServerRoleOptional

Настраивает ферму так, чтобы указывать роль сервера не требовалось. Если роль сервера не указана, по умолчанию используется роль Custom.

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False
Применяется к:SharePoint Server Subscription Edition

-SiteMapDatabaseName

Не следует использовать. Указывает имя базы данных для карты веб-сайта.

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False
Применяется к:SharePoint Server Subscription Edition

-SiteMapDatabaseServer

Не следует использовать. Указывает имя сервера базы данных для карты веб-сайта.

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False
Применяется к:SharePoint Server Subscription Edition

-SkipRegisterAsDistributedCacheHost

По умолчанию все серверы в ферме регистрируются как узлы кэша (то есть, по умолчанию запущена служба DistributedCacheService ).

При использовании этого параметра сервер не регистрируется как узел распределенного кэша. Чтобы выделить отдельный узел кэша, этот параметр используется для проверки наличия на этом компьютере установленной службы кэширования.

Тип:SwitchParameter
Position:9
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False
Применяется к:SharePoint Server Subscription Edition