Connect-SPConfigurationDatabase

リファレンス

モジュール:: sharepoint-server

適用対象:: SharePoint Server Subscription Edition

ローカルサーバーコンピューターをファームに接続します。

構文

Connect-SPConfigurationDatabase
       [-DatabaseName] <String>
       [-SkipRegisterAsDistributedCacheHost]
       [-Passphrase] <SecureString>
       -DatabaseServer <String>
       [-AssignmentCollection <SPAssignmentCollection>]
       [-DatabaseCredentials <PSCredential>]
       [-DatabaseFailOverPartner <String>]
       [-LocalServerRole <SPServerRole>]
       [<CommonParameters>]

説明

Connect-SPConfigurationDatabase コマンドレットでは、指定した構成データベースに現在のサーバーを接続します。

基本的に、このコマンドレットは、サーバーをファームに接続します。現在のコンピューターをファームに接続できない場合、次のようなエラーメッセージが表示されます。

"このコンピューターは既に SharePoint ファームに接続されています。 Dismount-SPConfigurationDatabase を参照してください"

Windows PowerShell for SharePoint 製品のアクセス許可と最新情報については、「SharePoint Server コマンドレット」のオンラインドキュメントをご覧ください。

例

------------------ 例 ------------------

Connect-SPConfigurationDatabase -DatabaseServer "ServerName\InstanceName" -DatabaseName "SharePointConfigurationDatabaseName" -Passphrase (ConvertTo-SecureString "MyP@ssw0rd" -AsPlainText -Force)
Start-Service SPTimerv4

この例では、ServerName\InstanceName という名前を使用して、SQL Server のインスタンス上にあるデータベース SharePointConfigurationDatabase を使用するように構成されたファームにローカルサーバーコンピューターを接続します。パスワードには MyP@ssw0rd を使用します。

パラメーター

-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

データベース SQL 認証用のユーザー名とパスワードを含む PSCredential オブジェクトを指定します。このパラメーターを指定しない場合は、現在のユーザーが使用されます。

この型は、有効な PSCredential オブジェクトであることが必要です。

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

-DatabaseFailOverPartner

SQL Server インスタンスのデータベースミラーリングパートナーを指定します。

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

-DatabaseName

サーバーの接続先の構成データベースの名前を指定します。

この型は、有効なデータベース名 (DB1 など) であることが必要です。

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:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-LocalServerRole

ローカルサーバーに割り当てられた MinRole を指定します。

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

-Passphrase

現在のサーバーを構成データベースに接続するための安全なパスワードを指定します。

この型は、セキュリティで保護された有効な文字列 (MyBDCApp1serverkey など) であることが必要です。

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

-SkipRegisterAsDistributedCacheHost

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

このパラメーターを使用して、サーバーコンピューターが分散キャッシュホストとして登録されないように指定します。専用キャッシュホストが必要な場合は、このパラメーターを使用して、キャッシュサービスがコンピューターにインストールされないようにします。

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