Set-​CM​Email​Notification​Component

Changes configuration settings of an email notification component.

Syntax

Set-CMEmailNotificationComponent
   [-DisableEmailNotification]
   [-Confirm]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [<CommonParameters>]
Set-CMEmailNotificationComponent
   [-EnableEmailNotification]
   [-Confirm]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-Port <Int32>]
   -SendFrom <String>
   -SmtpServerFqdn <String>
   -TypeOfAuthentication <AuthenticationMethod>
   [-UseSsl <Boolean>]
   [-UserName <String>]
   [-WhatIf]
   [<CommonParameters>]

Description

The Set-CMEmailNotificationComponent cmdlet changes configuration settings of an email notification component in Microsoft System Center Configuration Manager. You can configure the email notification component for each System Center Configuration Manager site to configure email subscriptions to alerts.

Examples

Example 1: Enable email notification

PS C:\> Set-CMEmailNotificationComponent -SiteSystemServerName "cmcen-dist02.tsqa.corp.contoso.com" -SiteCode "CM2" -EnableEmailNotification $True -MstpServerFqdn "mail.corp.contosco.com" -Port 25 -TypeOfAuthentication DefaultServiceAccount -SendFrom "evan.narvaez@contoso.com"

This command enables email notification for System Center Configuration Manager. The command specifies that System Center Configuration Manager uses the System Center Configuration Manager site that has the site code CM2 on the server cmcen-dist02.tsqa.corp.contoso.com to host the site system role for email notification. The command specifies that System Center Configuration Manager uses the server named mail.corp.contosco.com for the email server and specifies the outgoing SMTP port for sending email alerts. The command specifies that System Center Configuration Manager uses the default service account for authenticating the site server to the SMTP Server, and specifies that System Center Configuration Manager sends email alerts from the email address evan.narvaez@contoso.com.

Example 2: Disable email notification

PS C:\> Set-CMEmailNotificationComponent -SiteSystemServerName "cmcen-dist02.tsqa.corp.contoso.com" -EnableEmailNotification $False

This command disables email notification for System Center Configuration Manager on the site server named cmcen-dist02.tsqa.corp.contoso.com.

Example 3: Set the outgoing SMTP port for email notification

PS C:\> Set-CMEmailNotificationComponent -SiteSystemServerName "cmcen-dist02.tsqa.corp.contoso.com" -Port 27

This command sets the outgoing SMTP port that System Center Configuration Manager uses for sending email alerts on the site server named cmcen-dist02.tsqa.corp.contoso.com to port 27.

Required Parameters

-DisableEmailNotification

Indicates that email notification is disabled.

Type:SwitchParameter
Position:0
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-EnableEmailNotification

Indicates that Configuration Manager uses an SMTP server to send email alerts.

Type:SwitchParameter
Position:0
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-SendFrom

Specifies the email address from which Configuration Manager sends email alerts.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-SmtpServerFqdn

Specifies the fully qualified domain name (FQDN) of the SMTP server.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-TypeOfAuthentication

Specifies the method by which Configuration Manager authenticates the site server to the SMTP Server. The acceptable values for this parameter are:- Anonymous

  • DefaultServiceAccount
  • Other
Type:AuthenticationMethod
Parameter Sets:Anonymous, DefaultServiceAccount, Other
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

Optional Parameters

-Confirm

Prompts you for confirmation before running the cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False
-DisableWildcardHandling

DisableWildcardHandling treats wildcard characters as literal character values. Cannot be combined with ForceWildcardHandling.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-ForceWildcardHandling

ForceWildcardHandling processes wildcard characters and may lead to unexpected behavior (not recommended). Cannot be combined with DisableWildcardHandling.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Port

Specifies the outgoing SMTP port for sending email alerts.

Type:Int32
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-UseSsl

{{Fill UseSsl Description}}

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-UserName

Specifies the user name to authenticate with the SMTP server from which Configuration Manager sends email alerts. This parameter also specifies the SMTP Server Connection account.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False