dbatools is a free PowerShell module with over 300 SQL Server administration, best practice and migration commands included.

Please note that documentation and command names may be out of date while we work furiously towards 1.0


This command copies SQL Agent operators from one SQL Server to another. By default, all operators are copied.

The -Operators parameter is autopopulated for command-line completion and can be used to copy only specific operators.

If the operator already exists on the destination, it will be skipped unless -Force is specified. Force drops and recreates the object. Dependencies are not currently copied over.


To copy all operators from sqlserver2014a to sqlcluster, using integrated (Windows) authentication. If operators with the same name exist on sqlcluster, they will be skipped.


To copy only two operators, operator1 and murrringoperator, from sqlserver2014a to sqlcluster, using SQL authentication for sqlserver2014a and integrated (Windows) authentication for sqlcluster. If an operator with the same name exists on sqlcluster, it will be dropped and recreated because -Force was used.


To see what would happen if the command were executed. No actions are actually performed.



From PowerShell, execute Get-Help Copy-DbaAgentOperator -Detailed for more information on this function.

Source Code

Want to see the source code? View Copy-DbaAgentOperator.ps1 on GitHub

Related commands