New-SPConfigurationDatabase

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

Синтаксис

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]
   [<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

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

Type:String
Position:5
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-AssignmentCollection

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

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

Type:SPAssignmentCollection
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-DatabaseCredentials

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

Type:PSCredential
Position:6
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-DatabaseFailOverServer

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-DatabaseName

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

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-DatabaseServer

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

Type:String
Position:2
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-DirectoryDomain

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

Type:String
Position:3
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-DirectoryOrganizationUnit

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

Type:String
Position:4
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-FarmCredentials

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

Type:PSCredential
Position:7
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-LocalServerRole

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

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

Type:SPServerRole
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-Passphrase

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

Type:SecureString
Position:8
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-ServerRoleOptional

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-SiteMapDatabaseName

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-SiteMapDatabaseServer

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-SkipRegisterAsDistributedCacheHost

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

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

Type:SwitchParameter
Position:9
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition