Database.SetDefaultFileGroup Method
Sets the default file group for the database.
Namespace: Microsoft.SqlServer.Management.Smo
Assembly: Microsoft.SqlServer.Smo (in Microsoft.SqlServer.Smo.dll)
Syntax
'Declaration
Public Sub SetDefaultFileGroup ( _
fileGroupName As String _
)
'Usage
Dim instance As Database
Dim fileGroupName As String
instance.SetDefaultFileGroup(fileGroupName)
public void SetDefaultFileGroup(
string fileGroupName
)
public:
void SetDefaultFileGroup(
String^ fileGroupName
)
member SetDefaultFileGroup :
fileGroupName:string -> unit
public function SetDefaultFileGroup(
fileGroupName : String
)
Parameters
- fileGroupName
Type: System.String
A String value that specifies the name of the default file group.
Remarks
This method sets the default file group that is used when new database files are created. Existing file groups can be referenced by using the FileGroups property. New file groups can be added by using the FileGroup constructor.
Examples
VB
'Connect to the local, default instance of SQL Server.
Dim srv As Server
srv = New Server
'Reference the AdventureWorks2012 database.
Dim db As Database
db = srv.Databases("AdventureWorks2012")
'Define a FileGroup object called SECONDARY on the database.
Dim fg1 As FileGroup
fg1 = New FileGroup(db, "FILEGROUP2")
'Call the Create method to create the file group on the
'instance of SQL Server.
fg1.Create()
'Define a DataFile object on the file group and set
'the FileName property.
Dim df1 As DataFile
df1 = New DataFile(fg1, "newfile")
df1.FileName = _
"c:\Program Files\Microsoft SQL Server\MSSQL11\MSSQL\DATA\newfile.ndf"
'Call the Create method to create the data file on the
'instance of SQL Server.
df1.Create()
'Set the new default file group for the database.
db.SetDefaultFileGroup(fg1.Name)
PowerShell
$srv = new-Object Microsoft.SqlServer.Management.Smo.Server("(local)")
$db = New-Object Microsoft.SqlServer.Management.Smo.Database
$db = $srv.Databases.Item("AdventureWorks2012")
$fg1 = new-object Microsoft.SqlServer.Management.Smo.FileGroup($db, "FILEGROUP2")
$fg1.Create()
$df1 = new-object Microsoft.SqlServer.Management.Smo.DataFile($fg1, "newfile")
$df1.FileName = "c:\Program Files\Microsoft SQL Server\MSSQL11\MSSQL\DATA\newfile.ndf"
$df1.Create()
$db.SetDefaultFileGroup($fg1.Name)
See Also
Reference
Microsoft.SqlServer.Management.Smo Namespace
Other Resources
Creating, Altering, and Removing Databases