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 for 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
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-AssignmentCollection

Manages objects for the purpose of proper disposal. Use of objects, such as SPWeb or SPSite, can use large amounts of memory and use of these objects in Windows PowerShell scripts requires proper memory management. Using the SPAssignment object, you can assign objects to a variable and dispose of the objects after they are needed to free up memory. When SPWeb, SPSite, or SPSiteAdministration objects are used, the objects are automatically disposed of if an assignment collection or the Global parameter is not used.

When the Global parameter is used, all objects are contained in the global store. If objects are not immediately used, or disposed of by using the Stop-SPAssignment command, an out-of-memory scenario can occur.

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

-DatabaseCredentials

Specifies the Credential object for the database user. Use this parameter if you use SQL Server Authentication. If no database credentials are provided, Windows authentication is used.

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

-DatabaseFailOverServer

構成データベースとサーバーの全体管理データベースのSQL Server データベース ミラー パートナー サーバーを指定します。

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

-DatabaseName

新しい構成データベースの名前を指定します。

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

-DatabaseServer

構成データベースを作成するデータベース サーバーを指定します。 値を指定しない場合は、既定値が使用されます。

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

-DirectoryDomain

Specifies the directory domain for the new farm. If no domain is specified, the domain in which the local computer is located is used.

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

-DirectoryOrganizationUnit

Specifies the directory organizational unit for the new configuration database. If no organizational unit is specified, the organizational unit in which the local computer is located is used.

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

-FarmCredentials

ファーム管理者アカウントの資格情報を指定します。

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

-LocalServerRole

サーバー ロールを指定します。 SharePoint Server 2016 のすべてのバージョンの有効なオプションSharePoint Server 2019: Custom, , SingleServerFarm, Application, WebFrontEnd, DistributedCache``Search

機能パック 1 を追加すると、次の新しいオプションが追加されました。 ApplicationWithSearch``WebFrontEndWithDistributedCache

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

-ServerRoleOptional

Configures the farm to not require a server role to be specified. If no server role is specified, the server defaults to the Custom role.

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

-SiteMapDatabaseName

使用しないでください。 サイト マップ サイトのデータベース名を指定します。

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

-SiteMapDatabaseServer

使用しないでください。 サイト マップ サイトのデータベース サーバー名を指定します。

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

-SkipRegisterAsDistributedCacheHost

既定では、ファーム内のすべてのサーバーがキャッシュ ホストとして登録されています (つまり DistributedCacheService は既定で実行されています)。

Use this parameter to not register the server computer as a distributed cache host. If you want to have a dedicated cache host, then use this parameter to make sure that caching service is not installed on the computer.

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

-パスフレーズ

新しいファームの安全なパスワード フレーズを指定します。 このパスフレーズを使用して、他のコンピューターをこのファームに参加させます。

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