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, которую необходимо обновить.
Обязательный? |
true |
Позиция? |
0 |
Значение по умолчанию |
нет |
Обрабатывать входные данные конвейера |
true (ByValue) |
Обрабатывать символы-шаблоны? |
false |
-Setting
Параметр Setting представляет собой объект системного параметра, указывающий имя системного параметра, который необходимо обновить.
Обязательный? |
true |
Позиция? |
1 |
Значение по умолчанию |
нет |
Обрабатывать входные данные конвейера |
true (ByValue) |
Обрабатывать символы-шаблоны? |
false |
-SettingValue
Параметр SettingValue представляет собой строку, указывающую новое значение, которое должно быть установлено для системного параметра. Если данный параметр не указан, будет использовано значение параметра Setting.
Обязательный? |
false |
Позиция? |
именованный |
Значение по умолчанию |
нет |
Обрабатывать входные данные конвейера |
true (ByPropertyName) |
Обрабатывать символы-шаблоны? |
false |
Входы и выходы
Входной тип — это тип объектов, которые можно направить в командлет. Возвращаемый тип — это тип объектов, возвращаемых командлетом.
Входы |
Microsoft.MasterDataServices.Configuration.DatabaseInformation, Microsoft.MasterDataServices.Services.DataContracts.SystemSetting, System.String Входные данные — это объект сведений о базе данных, объект системного параметра и строка, указывающая новое значение системного параметра. |
Выходы |
Нет. |
Примеры
Направление выходных данных и использование переменных
В следующем примере осуществляется направление объекта сведений о сервере баз данных из командлета Get-MasterDataServicesDatabaseServerInformation в командлет Set-MasterDataServicesSystemSetting. Выполняется получение текущего значения системного параметра Rows Per Batch и последующее обновление этого значения в базе данных 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;