Set-MasterDataServicesSystemSetting (PowerShell)
Master Data Services データベースの指定されたシステム設定の値を設定します。
構文
Set-MasterDataServicesSystemSetting [-Database] <Microsoft.MasterDataServices.Configuration.DatabaseInformation>
[-Setting] <Microsoft.MasterDataServices.Services.DataContracts.SystemSetting> [-SettingValue <String>]
説明
Set-MasterDataServicesSystemSetting は、Master Data Services データベースの指定されたシステム設定の値を設定します。
パラメーター
-Database
Database パラメーターは、Get-MasterDataServicesDatabase のデータベース情報オブジェクトです。このオブジェクトには、更新する Master Data Services データベースに関する情報が格納されます。
必須/オプション |
必須 |
位置 |
0 |
既定値 |
なし |
パイプライン入力の受け入れ |
可 (ByValue) |
ワイルドカード文字の受け入れ |
不可 |
-Setting
Setting パラメーターは、更新するシステム設定の名前を指定するシステム設定オブジェクトです。
必須/オプション |
必須 |
位置 |
1 |
既定値 |
なし |
パイプライン入力の受け入れ |
可 (ByValue) |
ワイルドカード文字の受け入れ |
不可 |
-SettingValue
SettingValue パラメーターは、システム設定に設定する新しい値を指定する文字列です。このパラメーターを指定しない場合は、Setting パラメーターの値が使用されます。
必須/オプション |
オプション |
位置 |
指定 |
既定値 |
なし |
パイプライン入力の受け入れ |
可 (ByPropertyName) |
ワイルドカード文字の受け入れ |
不可 |
入力および出力
入力型は、コマンドレットにパイプできるオブジェクトの型です。戻り値の型は、コマンドレットが返すオブジェクトの型です。
入力 |
Microsoft.MasterDataServices.Configuration.DatabaseInformation、Microsoft.MasterDataServices.Services.DataContracts.SystemSetting、System.String 入力は、データベース情報オブジェクト、システム設定オブジェクト、およびシステム設定の新しい値を指定する文字列です。 |
出力 |
なし。 |
使用例
出力のパイプと変数の使用
次の例では、Get-MasterDataServicesDatabaseServerInformation のデータベース サーバー情報オブジェクトを Set-MasterDataServicesSystemSetting にパイプします。これは、[バッチごとの行数] システム設定の現在の値を取得して、Master Data Services データベースの値を更新します。
C:\PS> # Get the database server information object
$dbInfo = Get-MasterDataServicesDatabaseServerInformation
-ConnectionString 'Data Source=MyServer\MyInstance;Initial Catalog=;Integrated Security=True;User ID=;Password=' |
Get-MasterDataServicesDatabase -DatabaseName 'MyDatabase';
# Retrieve the current RowsPerBatch system setting
$rowsPerBatchSetting = $dbInfo | Get-MasterDataServicesSystemSettings | where { $_.DisplayName -eq 'Rows Per Batch'};
# Display the current value of RowsPerBatch
write-host The current setting for RowsPerBatch is $rowsPerBatchSetting.SettingValue;
# Pipe the dbInfo object and set the setting value using the SettingValue parameter
$dbInfo | Set-MasterDataServicesSystemSetting -Setting $rowsPerBatchSetting -SettingValue '60';
# Retrieve the setting again to see if it was properly updated.
$newRowsPerBatch = $dbInfo | Get-MasterDataServicesSystemSettings | where { $_.DisplayName -eq 'Rows Per Batch' };
# Display the new value of RowsPerBatch.
write-host The new setting for RowsPerBatch is $rowsPerBatchSetting.SettingValue;