New-MasterDataServicesDatabase (PowerShell)
Master Data Services データベースを作成します。
構文
New-MasterDataServicesDatabase [-Server] <Microsoft.MasterDataServices.Configuration.DatabaseServerInformation>
[-DatabaseName] <String> [-AdminAccount] <String> [-Collation <String>]
説明
New-MasterDataServicesDatabase は、Master Data Services データベースを作成します。SQL Server の指定されたインスタンスが、Master Data Services データベースのホストについてサポートされているバージョンとエディションであることを確認し、そのインスタンス上にデータベースを作成する権限が指定されたアカウントに与えられていることを確認します。
パラメーター
-Server
Server パラメーターは、Get-MasterDataServicesDatabaseServerInformation のデータベース サーバー情報オブジェクトです。このオブジェクトは、Master Data Services データベースの作成先である SQL Server のインスタンスに接続するために使用されます。
必須/オプション |
必須 |
位置 |
0 |
既定値 |
なし |
パイプライン入力の受け入れ |
可 (ByValue) |
ワイルドカード文字の受け入れ |
不可 |
-DatabaseName
DatabaseName パラメーターは、新しい Master Data Services データベースの名前を指定する文字列です。
必須/オプション |
必須 |
位置 |
1 |
既定値 |
なし |
パイプライン入力の受け入れ |
不可 |
ワイルドカード文字の受け入れ |
不可 |
-AdminAccount
AdminAccount パラメーターは、新しい Master Data Services データベースに対する権限を付与するドメインおよび Windows アカウントを指定する文字列です。
必須/オプション |
必須 |
位置 |
2 |
既定値 |
なし |
パイプライン入力の受け入れ |
不可 |
ワイルドカード文字の受け入れ |
不可 |
-Collation
Collation パラメーターは、新しい Master Data Services データベースの照合順序を指定する文字列です。
必須/オプション |
オプション |
位置 |
指定 |
既定値 |
サーバーの既定の照合順序 |
パイプライン入力の受け入れ |
不可 |
ワイルドカード文字の受け入れ |
不可 |
入力および出力
入力型は、コマンドレットにパイプできるオブジェクトの型です。戻り値の型は、コマンドレットが返すオブジェクトの型です。
入力 |
Microsoft.MasterDataServices.Configuration.DatabaseServerInformation Get-MasterDataServicesDatabaseServerInformation のデータベース サーバー情報オブジェクト。 |
出力 |
なし |
使用例
出力
このコマンドレットを使用したときに返される出力の例を次に示します。
Name : MyDatabase
HasAccess : True
Collation : SQL_Latin1_General_CP1_CI_AS
ServiceAccount :
MdsAdministrator : MyDomain\AccountName
Server : Microsoft.MasterDataServices.Configuration.DatabaseServerInformation
IsDatabaseOwner : True
変数と名前付きパラメーターの使用
次の例では、Get-MasterDataServicesDatabaseServerInformation コマンドレットを使用して、変数 $server を New-MasterDataServicesDatabase コマンドレットの Server パラメーターで使用するように設定します。これらのパラメーターは名前付きパラメーターであり、照合順序が指定されていないので、新しいデータベースには既定の照合順序が使用されます。
C:\PS> $server = Get-MasterDataServicesDatabaseServerInformation
-ConnectionString 'Data Source=MyServer\MyInstance;Initial catalog=;Integrated Security=True;User ID=;Password=';
New-MasterDataServicesDatabase -Server $server
-DatabaseName 'MyDatabase' -AdminAccount 'MyDomain\AccountName';
出力のパイプと名前付きパラメーターの使用
次の例では、Get-MasterDataServicesDatabaseServerInformation の出力を、New-MasterDataServicesDatabase の Server パラメーターにパイプします。これらのパラメーターは、名前付きパラメーターです。
C:\PS> Get-MasterDataServicesDatabaseServerInformation
-ConnectionString 'Data Source=MyServer\MyInstance;Initial catalog=;Integrated Security=True;User ID=;Password=' |
New-MasterDataServicesDatabase -DatabaseName 'MyDatabase'
-AdminAccount 'MyDomain\AccountName' -Collation 'SQL_Latin1_General_CP1_CI_AS';
変数と位置パラメーターの使用
次の例では、Get-MasterDataServicesDatabaseServerInformation コマンドレットを使用して、変数 $server を New-MasterDataServicesDatabase コマンドレットの Server パラメーターで使用するように設定します。これらのパラメーターは位置パラメーターであり、照合順序が指定されていないので、新しいデータベースには既定の照合順序が使用されます。
C:\PS> $server = Get-MasterDataServicesDatabaseServerInformation
-ConnectionString 'Data Source=MyServer\MyInstance;Initial catalog=;Integrated Security=True;User ID=;Password=';
New-MasterDataServicesDatabase $server 'MyDatabase' 'MyDomain\AccountName';