Article
03/31/2012

Set-MasterDataServicesSystemSetting (PowerShell)

Définit la valeur d'un paramètre système spécifié dans une base de données Master Data Services.

Syntaxe

Set-MasterDataServicesSystemSetting [-Database] <Microsoft.MasterDataServices.Configuration.DatabaseInformation> 
        [-Setting] <Microsoft.MasterDataServices.Services.DataContracts.SystemSetting> [-SettingValue <String>]

Description

Set-MasterDataServicesSystemSetting définit la valeur d'un paramètre système spécifié dans une base de données Master Data Services.

Paramètres

-Database

Le paramètre Database est un objet d'informations sur la base de données de Get-MasterDataServicesDatabase. Cet objet contient des informations sur la base de données Master Data Services à mettre à jour.

Requis ?	true
Position ?	0
Valeur par défaut	aucune
Accepter l'entrée de pipeline	true (ByValue)
Accepter les caractères génériques ?	false

-Setting

Le paramètre Setting est un objet de paramètre système qui spécifie le nom du paramètre système à mettre à jour.

Requis ?	true
Position ?	1
Valeur par défaut	aucune
Accepter l'entrée de pipeline	true (ByValue)
Accepter les caractères génériques ?	false

-SettingValue

Le paramètre SettingValue est une chaîne qui spécifie la nouvelle valeur à définir pour le paramètre système. Si ce paramètre n'est pas spécifié, la valeur du paramètre Setting est utilisée.

Requis ?	false
Position ?	nommée
Valeur par défaut	aucune
Accepter l'entrée de pipeline	true (ByPropertyName)
Accepter les caractères génériques ?	false

Entrées et sorties

Le type d'entrée correspond au type des objets que vous pouvez canaliser vers l'applet de commande. Le type de retour correspond au type des objets retournés par l'applet de commande.

Entrées

Microsoft.MasterDataServices.Configuration.DatabaseInformation, Microsoft.MasterDataServices.Services.DataContracts.SystemSetting, System.String

L'entrée est un objet d'informations sur la base de données, un objet de paramètre système et une chaîne qui permet de spécifier une nouvelle valeur pour le paramètre système.

Sorties

Aucune.

Exemple

Canalisation de la sortie et utilisation de variables

Cet exemple canalise l'objet d'informations sur le serveur de base de données depuis Get-MasterDataServicesDatabaseServerInformation vers Set-MasterDataServicesSystemSetting. Il obtient la valeur actuelle du paramètre système Lignes par lot, puis met à jour la valeur dans la base de données 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;

Voir aussi

Référence

Get-MasterDataServicesDatabaseServerInformation (PowerShell)

Partager via