Set-MasterDataServicesSystemSetting (PowerShell)
Define o valor de uma configuração do sistema especificada em um banco de dados do Master Data Services.
Sintaxe
Set-MasterDataServicesSystemSetting [-Database] <Microsoft.MasterDataServices.Configuration.DatabaseInformation>
[-Setting] <Microsoft.MasterDataServices.Services.DataContracts.SystemSetting> [-SettingValue <String>]
Descrição
Set-MasterDataServicesSystemSetting define o valor de uma configuração do sistema especificada em um banco de dados do Master Data Services.
Parâmetros
-Database
O parâmetro Database é um objeto de informações de banco de dados de Get-MasterDataServicesDatabase. Esse objeto contém informações sobre o banco de dados do Master Data Services a ser atualizado.
Obrigatório? |
true |
Posição? |
0 |
Valor padrão |
nenhum |
Aceitar entrada de pipeline |
true (ByValue) |
Aceitar caracteres curinga? |
false |
-Setting
O parâmetro Setting é um objeto de configuração do sistema que especifica o nome da configuração do sistema a ser atualizada.
Obrigatório? |
true |
Posição? |
1 |
Valor padrão |
nenhum |
Aceitar entrada de pipeline |
true (ByValue) |
Aceitar caracteres curinga? |
false |
-SettingValue
O parâmetro SettingValue é uma cadeia de caracteres que especifica o novo valor a ser definido para a configuração do sistema. Se esse parâmetro não for especificado, será usado o valor do parâmetro Setting.
Obrigatório? |
false |
Posição? |
nomeado |
Valor padrão |
nenhum |
Aceitar entrada de pipeline |
true (ByPropertyName) |
Aceitar caracteres curinga? |
false |
Entradas e saídas
O tipo de entrada é o tipo dos objetos que você pode transportar para o cmdlet. O tipo de retorno é o tipo dos objetos que o cmdlet retorna.
Entradas |
Microsoft.MasterDataServices.Configuration.DatabaseInformation, Microsoft.MasterDataServices.Services.DataContracts.SystemSetting, System.String A entrada é um objeto de informações do banco de dados, um objeto de configuração do sistema e uma cadeia de caracteres para especificar um novo valor para a configuração do sistema. |
Saídas |
Nenhuma. |
Exemplos
Saída do pipe e uso de variáveis
Este exemplo transporta o objeto de informações do servidor de banco de dados de Get-MasterDataServicesDatabaseServerInformation para Set-MasterDataServicesSystemSetting. Ele obtém o valor atual da configuração do sistema Linhas Por Lote e atualiza esse valor no banco de dados do 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;