SqlAgentOperator

Parameters

Parameter	Attribute	DataType	Description	Allowed Values
Name	Key	String	The name of the SQL Server Agent operator.
Ensure	Write	String	Specifies if the SQL Server Agent operator should be present or absent. Default value is 'Present'.	Present, Absent
ServerName	Write	String	The host name of the SQL Server to be configured. Default value is the current computer name.
InstanceName	Key	String	The name of the SQL Server instance to be configured.
EmailAddress	Write	String	The email address to be used for the SQL Server Agent operator.

Description

The SqlAgentOperator DSC resource is used to add/remove SQL Agent Operators. The resource can also update the operators email address.

Requirements

• Target machine must be running Windows Server 2012 or later.
• Target machine must be running SQL Server Database Engine 2012 or later.

Known issues

All issues are not listed here, see here for all open issues.

Examples

Example 1

This example shows how to ensure that the SQL Agent Operator DbaTeam exists with the correct email address.

Configuration Example
{
    Import-DscResource -ModuleName 'SqlServerDsc'

    node localhost
    {
        SqlAgentOperator 'Add_DbaTeam'
        {
            Ensure       = 'Present'
            Name         = 'DbaTeam'
            ServerName   = 'TestServer'
            InstanceName = 'MSSQLServer'
            EmailAddress = 'dbateam@company.com'
        }
    }
}

Example 2

This example shows how to ensure that the SQL Agent Operator DbaTeam does not exist.

Configuration Example
{

    Import-DscResource -ModuleName 'SqlServerDsc'

    node localhost
    {
        SqlAgentOperator 'Remove_DbaTeam'
        {
            Ensure       = 'Absent'
            Name         = 'DbaTeam'
            ServerName   = 'TestServer'
            InstanceName = 'MSSQLServer'
        }
    }
}