< Back
Set-DbaDbIdentity
Post
NAME Set-DbaDbIdentity
SYNOPSIS
Checks and updates the current identity value via DBCC CHECKIDENT
SYNTAX
Set-DbaDbIdentity [-SqlInstance] <Sqlcollaborative.Dbatools.Parameter.DbaInstanceParameter[]> [[-SqlCredential]
<Pscredential>] [[-Database] <System.String[]>] [[-Table] <System.String[]>] [[-ReSeedValue] <Int>]
[-EnableException <Switch>] [<CommonParameters>]
DESCRIPTION
Use the command DBCC CHECKIDENT to check and if necessary update the current identity value of a table and return
results
Can update an individual table via the ReSeedValue and RESEED option of DBCC CHECKIDENT
Read more:
- https://docs.microsoft.com/en-us/sql/t- ... ansact-sql
PARAMETERS
-Database [<System.String[]>]
The database(s) to process - this list is auto-populated from the server. If unspecified, all databases will
be processed.
Only one database should be specified when using a RESEED value
Required? false
Position? named
Default value
Accept pipeline input? False
Accept wildcard characters? false
-EnableException [<Switch>]
By default, when something goes wrong we try to catch it, interpret it and give you a friendly warning message.
This avoids overwhelming you with "sea of red" exceptions, but is inconvenient because it basically disables
advanced scripting.
Using this switch turns this "nice by default" feature off and enables you to catch exceptions with your own
try/catch.
Required? false
Position? named
Default value
Accept pipeline input? False
Accept wildcard characters? false
-ReSeedValue [<Int>]
The new reseed value to be used to set as the current identity value.
Required? false
Position? named
Default value
Accept pipeline input? False
Accept wildcard characters? false
-SqlCredential [<Pscredential>]
Login to the target instance using alternative credentials. Accepts PowerShell credentials (Get-Credential).
Windows Authentication, SQL Server Authentication, Active Directory - Password, and Active Directory -
Integrated are all supported.
For MFA support, please use Connect-DbaInstance.
Required? false
Position? named
Default value
Accept pipeline input? False
Accept wildcard characters? false
-SqlInstance [<Sqlcollaborative.Dbatools.Parameter.DbaInstanceParameter[]>]
The target SQL Server instance or instances.
Required? false
Position? named
Default value
Accept pipeline input? False
Accept wildcard characters? false
-Table [<System.String[]>]
The table(s) for which to check the current identity value.
Only one table should be specified when using a RESEED value
Required? false
Position? named
Default value
Accept pipeline input? False
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https:/go.microsoft.com/fwlink/?LinkID=113216).
INPUTS
OUTPUTS
NOTES
Tags: DBCC
Author: Patrick Flynn (@sqllensman)
Website: https://dbatools.io
Copyright: (c) 2018 by dbatools, licensed under MIT
License: MIT https://opensource.org/licenses/MIT
-------------------------- EXAMPLE 1 --------------------------
PS C:\\>Set-DbaDbIdentity -SqlInstance SQLServer2017 -Database AdventureWorks2014 -Table 'Production.ScrapReason'
Connects to AdventureWorks2014 on instance SqlServer2017 using Windows Authentication and runs the command DBCC
CHECKIDENT('Production.ScrapReason') to return the current identity value.
-------------------------- EXAMPLE 2 --------------------------
PS C:\\>$cred = Get-Credential sqladmin
PS C:\\> 'Sql1','Sql2/sqlexpress' | Set-DbaDbIdentity -SqlCredential $cred -Database AdventureWorks2014 -Table
'Production.ScrapReason'
Connects to AdventureWorks2014 on instances Sql1 and Sql2/sqlexpress using sqladmin credential and runs the
command DBCC CHECKIDENT('Production.ScrapReason') to return the current identity value.
-------------------------- EXAMPLE 3 --------------------------
PS C:\\>$query = "Select Schema_Name(t.schema_id) +'.' + t.name as TableName from sys.columns c INNER JOIN
sys.tables t on t.object_id = c.object_id WHERE is_identity = 1"
PS C:\\> $IdentityTables = Invoke-DbaQuery -SqlInstance SQLServer2017 -Database AdventureWorks2014 -Query $query
PS C:\\> foreach ($tbl in $IdentityTables) {
PS C:\\> Set-DbaDbIdentity -SqlInstance SQLServer2017 -Database AdventureWorks2014 -Table $tbl.TableName
PS C:\\> }
Checks the current identity value for all tables with an Identity in the AdventureWorks2014 database on the
SQLServer2017 and, if it is needed, changes the identity value.
RELATED LINKS
https://dbatools.io/Set-DbaDbIdentity
SYNOPSIS
Checks and updates the current identity value via DBCC CHECKIDENT
SYNTAX
Set-DbaDbIdentity [-SqlInstance] <Sqlcollaborative.Dbatools.Parameter.DbaInstanceParameter[]> [[-SqlCredential]
<Pscredential>] [[-Database] <System.String[]>] [[-Table] <System.String[]>] [[-ReSeedValue] <Int>]
[-EnableException <Switch>] [<CommonParameters>]
DESCRIPTION
Use the command DBCC CHECKIDENT to check and if necessary update the current identity value of a table and return
results
Can update an individual table via the ReSeedValue and RESEED option of DBCC CHECKIDENT
Read more:
- https://docs.microsoft.com/en-us/sql/t- ... ansact-sql
PARAMETERS
-Database [<System.String[]>]
The database(s) to process - this list is auto-populated from the server. If unspecified, all databases will
be processed.
Only one database should be specified when using a RESEED value
Required? false
Position? named
Default value
Accept pipeline input? False
Accept wildcard characters? false
-EnableException [<Switch>]
By default, when something goes wrong we try to catch it, interpret it and give you a friendly warning message.
This avoids overwhelming you with "sea of red" exceptions, but is inconvenient because it basically disables
advanced scripting.
Using this switch turns this "nice by default" feature off and enables you to catch exceptions with your own
try/catch.
Required? false
Position? named
Default value
Accept pipeline input? False
Accept wildcard characters? false
-ReSeedValue [<Int>]
The new reseed value to be used to set as the current identity value.
Required? false
Position? named
Default value
Accept pipeline input? False
Accept wildcard characters? false
-SqlCredential [<Pscredential>]
Login to the target instance using alternative credentials. Accepts PowerShell credentials (Get-Credential).
Windows Authentication, SQL Server Authentication, Active Directory - Password, and Active Directory -
Integrated are all supported.
For MFA support, please use Connect-DbaInstance.
Required? false
Position? named
Default value
Accept pipeline input? False
Accept wildcard characters? false
-SqlInstance [<Sqlcollaborative.Dbatools.Parameter.DbaInstanceParameter[]>]
The target SQL Server instance or instances.
Required? false
Position? named
Default value
Accept pipeline input? False
Accept wildcard characters? false
-Table [<System.String[]>]
The table(s) for which to check the current identity value.
Only one table should be specified when using a RESEED value
Required? false
Position? named
Default value
Accept pipeline input? False
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https:/go.microsoft.com/fwlink/?LinkID=113216).
INPUTS
OUTPUTS
NOTES
Tags: DBCC
Author: Patrick Flynn (@sqllensman)
Website: https://dbatools.io
Copyright: (c) 2018 by dbatools, licensed under MIT
License: MIT https://opensource.org/licenses/MIT
-------------------------- EXAMPLE 1 --------------------------
PS C:\\>Set-DbaDbIdentity -SqlInstance SQLServer2017 -Database AdventureWorks2014 -Table 'Production.ScrapReason'
Connects to AdventureWorks2014 on instance SqlServer2017 using Windows Authentication and runs the command DBCC
CHECKIDENT('Production.ScrapReason') to return the current identity value.
-------------------------- EXAMPLE 2 --------------------------
PS C:\\>$cred = Get-Credential sqladmin
PS C:\\> 'Sql1','Sql2/sqlexpress' | Set-DbaDbIdentity -SqlCredential $cred -Database AdventureWorks2014 -Table
'Production.ScrapReason'
Connects to AdventureWorks2014 on instances Sql1 and Sql2/sqlexpress using sqladmin credential and runs the
command DBCC CHECKIDENT('Production.ScrapReason') to return the current identity value.
-------------------------- EXAMPLE 3 --------------------------
PS C:\\>$query = "Select Schema_Name(t.schema_id) +'.' + t.name as TableName from sys.columns c INNER JOIN
sys.tables t on t.object_id = c.object_id WHERE is_identity = 1"
PS C:\\> $IdentityTables = Invoke-DbaQuery -SqlInstance SQLServer2017 -Database AdventureWorks2014 -Query $query
PS C:\\> foreach ($tbl in $IdentityTables) {
PS C:\\> Set-DbaDbIdentity -SqlInstance SQLServer2017 -Database AdventureWorks2014 -Table $tbl.TableName
PS C:\\> }
Checks the current identity value for all tables with an Identity in the AdventureWorks2014 database on the
SQLServer2017 and, if it is needed, changes the identity value.
RELATED LINKS
https://dbatools.io/Set-DbaDbIdentity