Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
In SMO enthalten das Information Objekt, das Settings Objekt, das UserOptions Objekt und das Configuration Objekt Einstellungen und Informationen für die Instanz von Microsoft SQL Server.
SQL Server verfügt über zahlreiche Eigenschaften, die das Verhalten der installierten Instanz beschreiben. Die Eigenschaften beschreiben die Startoptionen, die Serverstandardeinstellungen, Dateien und Verzeichnisse, System- und Prozessorinformationen, Produkt- und Versionsinformationen, Verbindungsinformationen, Speicheroptionen, Sprach- und Sortierauswahlen sowie den Authentifizierungsmodus.
SQL Server-Konfiguration
Die Information Objekteigenschaften enthalten Informationen zur Instanz von SQL Server, z. B. Prozessor und Plattform.
Die Settings Objekteigenschaften enthalten Informationen zur Instanz von SQL Server. Die Standarddatenbankdatei und das Standardverzeichnis können zusätzlich zum E-Mail-Profil und dem Serverkonto geändert werden. Diese Eigenschaften verbleiben für die Dauer der Verbindung.
Die UserOptions Objekteigenschaften enthalten Informationen zum aktuellen Verbindungsverhalten im Zusammenhang mit arithmetischen, ANSI-Standards und Transaktionen.
Es gibt auch eine Reihe von Konfigurationsoptionen, die durch das Configuration Objekt dargestellt werden. Sie enthält eine Reihe von Eigenschaften, die die Optionen darstellen, die von der sp_configure gespeicherten Prozedur geändert werden können. Optionen wie Prioritätsverstärkung, Wiederherstellungsintervall und Netzwerkpaketgrößesteuern die Leistung der SQL Server-Instanz. Viele dieser Optionen können dynamisch geändert werden, aber in einigen Fällen wird der Wert zuerst konfiguriert und dann geändert, wenn die Instanz von SQL Server neu gestartet wird.
Für jede Konfigurationsoption gibt es eine Configuration Objekteigenschaft. Mit dem ConfigProperty Objekt können Sie die globale Konfigurationseinstellung ändern. Viele Eigenschaften weisen maximale und minimale Werte auf, die auch als ConfigProperty Eigenschaften gespeichert werden. Diese Eigenschaften erfordern die Alter Methode, um die Änderung an der Instanz von SQL Server zu übernehmen.
Alle Konfigurationsoptionen im Configuration Objekt müssen vom Systemadministrator geändert werden.
Beispiele
Für die folgenden Codebeispiele müssen Sie die Programmierumgebung, die Programmiervorlage und die Programmiersprache auswählen, um Ihre Anwendung zu erstellen. Weitere Informationen finden Sie unter Erstellen eines Visual Basic-SMO-Projekts in Visual Studio .NET und Erstellen eines Visual C#-SMO-Projekts in Visual Studio .NET.
Ändern von SQL Server-Konfigurationsoptionen in Visual Basic
Das Codebeispiel zeigt, wie eine Konfigurationsoption in Visual Basic .NET aktualisiert wird. Außerdem werden Informationen zu maximalen und minimalen Werten für die angegebene Konfigurationsoption abgerufen und angezeigt. Schließlich informiert das Programm den Benutzer darüber, ob die Änderung dynamisch vorgenommen wurde oder ob sie gespeichert wird, bis die Instanz von SQL Server neu gestartet wird.
Ändern von SQL Server-Einstellungen in Visual Basic
Im Codebeispiel werden Informationen zur Instanz von SQL Server in Information und Settingsund sowie Einstellungen in Settings und UserOptionsObjekteigenschaften angezeigt.
Im Beispiel haben das UserOptions Objekt und das Settings Objekt beide eine Alter Methode. Sie können die Alter Methoden für diese einzeln ausführen.
Ändern von SQL Server-Einstellungen in Visual C#
Im Codebeispiel werden Informationen zur Instanz von SQL Server in Information und Settingsund sowie Einstellungen in Settings und UserOptionsObjekteigenschaften angezeigt.
Im Beispiel haben das UserOptions Objekt und das Settings Objekt beide eine Alter Methode. Sie können die Alter Methoden für diese einzeln ausführen.
//Connect to the local, default instance of SQL Server.
{
Server srv = new Server();
//Display all the configuration options.
foreach (ConfigProperty p in srv.Configuration.Properties)
{
Console.WriteLine(p.DisplayName);
}
Console.WriteLine("There are " + srv.Configuration.Properties.Count.ToString() + " configuration options.");
//Display the maximum and minimum values for ShowAdvancedOptions.
int min = 0;
int max = 0;
min = srv.Configuration.ShowAdvancedOptions.Minimum;
max = srv.Configuration.ShowAdvancedOptions.Maximum;
Console.WriteLine("Minimum and Maximum values are " + min + " and " + max + ".");
//Modify the value of ShowAdvancedOptions and run the Alter method.
srv.Configuration.ShowAdvancedOptions.ConfigValue = 0;
srv.Configuration.Alter();
//Display when the change takes place according to the IsDynamic property.
if (srv.Configuration.ShowAdvancedOptions.IsDynamic == true)
{
Console.WriteLine("Configuration option has been updated.");
}
else
{
Console.WriteLine("Configuration option will be updated when SQL Server is restarted.");
}
}
Ändern der SQL Server-Einstellungen in PowerShell
Im Codebeispiel werden Informationen zur Instanz von SQL Server in Information und Settingsund sowie Einstellungen in Settings und UserOptionsObjekteigenschaften angezeigt.
Im Beispiel haben das UserOptions Objekt und das Settings Objekt beide eine Alter Methode. Sie können die Alter Methoden für diese einzeln ausführen.
# Set the path context to the local, default instance of SQL Server.
CD \sql\localhost\
$srv = Get-Item default
#Display information about the instance of SQL Server in Information and Settings.
"OS Version = " + $srv.Information.OSVersion
"State = "+ $srv.Settings.State.ToString()
#Display information specific to the current user in UserOptions.
"Quoted Identifier support = " + $srv.UserOptions.QuotedIdentifier
#Modify server settings in Settings.
$srv.Settings.LoginMode = [Microsoft.SqlServer.Management.SMO.ServerLoginMode]::Integrated
#Modify settings specific to the current connection in UserOptions.
$srv.UserOptions.AbortOnArithmeticErrors = $true
#Run the Alter method to make the changes on the instance of SQL Server.
$srv.Alter()
Ändern von SQL Server-Konfigurationsoptionen in PowerShell
Das Codebeispiel zeigt, wie eine Konfigurationsoption in Visual Basic .NET aktualisiert wird. Außerdem werden Informationen zu maximalen und minimalen Werten für die angegebene Konfigurationsoption abgerufen und angezeigt. Schließlich informiert das Programm den Benutzer darüber, ob die Änderung dynamisch vorgenommen wurde oder ob sie gespeichert wird, bis die Instanz von SQL Server neu gestartet wird.
#Get a server object which corresponds to the default instance replace LocalMachine with the physical server
cd \sql\LocalMachine
$svr = Get-Item default
#enumerate its properties
foreach ($Item in $Svr.Configuration.Properties)
{
$Item.DisplayName
}
"There are " + $svr.Configuration.Properties.Count.ToString() + " configuration options."
#Display the maximum and minimum values for ShowAdvancedOptions.
$min = $svr.Configuration.ShowAdvancedOptions.Minimum
$max = $svr.Configuration.ShowAdvancedOptions.Maximum
"Minimum and Maximum values are " + $min.ToString() + " and " + $max.ToString() + "."
#Modify the value of ShowAdvancedOptions and run the Alter method.
$svr.Configuration.ShowAdvancedOptions.ConfigValue = 0
$svr.Configuration.Alter()
#Display when the change takes place according to the IsDynamic property.
If ($svr.Configuration.ShowAdvancedOptions.IsDynamic -eq $true)
{
"Configuration option has been updated."
}
Else
{
"Configuration option will be updated when SQL Server is restarted."
}