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

-AssignmentCollection

適切な破棄を行うためにオブジェクトを管理します。 SPWeb や SPSite などのオブジェクトの使用によって大量のメモリが使用される場合があるので、Windows PowerShell スクリプトでこれらのオブジェクトを使用するには適切なメモリ管理が必要です。メモリの解放が必要になった場合は、SPAssignment オブジェクトを使用して、変数へのオブジェクトの割り当てとオブジェクトの破棄を行うことができます。割り当てコレクションまたは Global パラメーターが使用されていない場合、SPWeb、SPSite、または SPSiteAdministration オブジェクトが使用されていると、オブジェクトは自動的に破棄されます。

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

データベースユーザーの Credential オブジェクトを指定します。 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 データベースミラーパートナーサーバーを指定します。

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、CustomSingleServerFarm、、ApplicationWebFrontEnd、ですDistributedCache。Search

機能パック 1 を追加すると、新しいオプションには、が含まれます。 ApplicationWithSearchWebFrontEndWithDistributedCache

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

サーバーの役割を指定する必要がないようにファームを構成します。サーバーの役割を指定しないと、既定でサーバーはカスタムの役割になります。

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