Set-MasterDataServicesSystemSetting (PowerShell)
Legt den Wert einer angegebenen Systemeinstellung in einer Master Data Services-Datenbank fest.
Syntax
Set-MasterDataServicesSystemSetting [-Database] <Microsoft.MasterDataServices.Configuration.DatabaseInformation>
[-Setting] <Microsoft.MasterDataServices.Services.DataContracts.SystemSetting> [-SettingValue <String>]
Beschreibung
Set-MasterDataServicesSystemSetting legt den Wert einer angegebenen Systemeinstellung in einer Master Data Services-Datenbank fest.
Parameter
-Database
Der Datenbankparameter ist ein Datenbankinformationsobjekt aus Get-MasterDataServicesDatabase. Dieses Objekt enthält Informationen zu der zu aktualisierenden Master Data Services-Datenbank.
Erforderlich? |
true |
Position? |
0 |
Standardwert |
Keine |
Pipelineeingabe akzeptieren |
true (ByValue) |
Platzhalterzeichen akzeptieren? |
false |
-Setting
Der Setting-Parameter ist ein Objekt zur Systemeinstellung, das den Namen der zu aktualisierenden Systemeinstellung angibt.
Erforderlich? |
true |
Position? |
1 |
Standardwert |
Keine |
Pipelineeingabe akzeptieren |
true (ByValue) |
Platzhalterzeichen akzeptieren? |
false |
-SettingValue
Der SettingValue-Parameter ist eine Zeichenfolge, die den neuen für die Systemeinstellung festzulegenden Wert angibt. Wenn dieser Parameter nicht angegeben ist, wird der Wert im Setting-Parameter verwendet.
Erforderlich? |
false |
Position? |
benannt |
Standardwert |
Keine |
Pipelineeingabe akzeptieren |
true (ByPropertyName) |
Platzhalterzeichen akzeptieren? |
false |
Eingaben und Ausgaben
Mit Eingabetyp wird festgelegt, welchen Typ von Objekten Sie über die Pipeline an das Cmdlet übergeben können. Der Rückgabetyp bezeichnet den Typ der vom Cmdlet zurückgegebenen Objekte.
Eingaben |
Microsoft.MasterDataServices.Configuration.DatabaseInformation, Microsoft.MasterDataServices.Services.DataContracts.SystemSetting, System.String Als Eingabe dienen ein Datenbankinformationsobjekt, ein Systemeinstellungsobjekt und eine Zeichenfolge, um einen Wert für die Systemeinstellung anzugeben. |
Ausgaben |
Keine. |
Beispiele
Übergeben von Ausgabe über die Pipeline und Verwenden von Variablen
In diesem Beispiel wird das Informationsobjekt des Datenbankservers über die Pipeline von Get-MasterDataServicesDatabaseServerInformation an Set-MasterDataServicesSystemSetting übergeben. Es ruft den aktuellen Wert der Systemeinstellung Rows per Batch ab und aktualisiert dann den Wert in der Master Data Services-Datenbank.
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;