Export (0) Print
Expand All
Expand Minimize

Add-SCOMNotificationSubscriber

Updated: January 26, 2014

Applies To: System Center 2012 R2 Operations Manager

Add-SCOMNotificationSubscriber

Adds a notification subscriber in Operations Manager.

Syntax

Parameter Set: DeviceName
Add-SCOMNotificationSubscriber [-Name] <String> [-DeviceList] <String[]> [-ComputerName <String[]> ] [-Credential <PSCredential> ] [-SCSession <Connection[]> ] [ <CommonParameters>]

Parameter Set: DeviceTable
Add-SCOMNotificationSubscriber [-Name] <String> [-DeviceTable] <Hashtable> [-ComputerName <String[]> ] [-Credential <PSCredential> ] [-SCSession <Connection[]> ] [ <CommonParameters>]




Detailed Description

The Add-SCOMNotificationSubscriber cmdlet adds a notification subscriber in System Center 2012 – Operations Manager.

Notification subscribers receive notifications from Operations Manager.

Parameters

-ComputerName<String[]>

Specifies an array of names of computers. The cmdlet establishes temporary connections with management groups for these computers. You can use NetBIOS names, IP addresses, or fully qualified domain names (FQDNs). To specify the local computer, type the computer name, localhost, or a dot (.).


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

true (ByValue)

Accept Wildcard Characters?

false

-Credential<PSCredential>

Specifies a PSCredential object for the management group connection. To obtain a PSCredential object, use the Get-Credential cmdlet. For more information, type "Get-Help Get-Credential". If you specify a computer in the ComputerName parameter, use an account that has access to that computer. The default is the current user.


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

true (ByValue)

Accept Wildcard Characters?

false

-DeviceList<String[]>

Specifies an array of notification addresses. Use username@domain.com form for email addresses, SMS:<address> for SMS addresses, and SIP:<address> for IM addresses. Specify the name of a channel for a command channel.


Aliases

none

Required?

true

Position?

2

Default Value

none

Accept Pipeline Input?

true (ByPropertyName)

Accept Wildcard Characters?

false

-DeviceTable<Hashtable>

Specifies a table of named addresses. Use username@domain.com form for email addresses, SMS:<address> for SMS addresses, and SIP:<address> for IM addresses. Specify the name of a channel for a command channel.


Aliases

none

Required?

true

Position?

2

Default Value

none

Accept Pipeline Input?

true (ByPropertyName)

Accept Wildcard Characters?

false

-Name<String>

Specifies the name of a notification subscriber.


Aliases

none

Required?

true

Position?

1

Default Value

none

Accept Pipeline Input?

true (ByValue, ByPropertyName)

Accept Wildcard Characters?

false

-SCSession<Connection[]>

Specifies an array of Connection objects. To obtain a Connection object, use the Get-SCManagementGroupConnection cmdlet.


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

true (ByValue)

Accept Wildcard Characters?

false

<CommonParameters>

This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see about_CommonParameters.

Inputs

The input type is the type of the objects that you can pipe to the cmdlet.

Outputs

The output type is the type of the objects that the cmdlet emits.

Examples

Example 1: Add a notification subscriber

This command adds a new notification subscriber with email, SMS, and IM addresses.


PS C:\> Add-SCOMNotificationSubscriber -Name "Sarah Jones" -DeviceList "SarahJones@contoso.com", "sms:2065551212", "sip:SarahJ"

Example 2: Add a notification subscriber with a command channel

This example adds a new notification subscriber with an SMS address and a command address.

The first command uses the Get-SCOMNotificationChannel cmdlet to get the notification channel that has the display name OnNotify.exe, and stores the result in the $CommandChannel variable.

The second command adds a notification subscriber by using the Name parameter.


PS C:\> $CommandChannel = Get-SCOMNotificationChannel -DisplayName "OnNotify.exe"
PS C:\> Add-SCOMNotificationSubscriber -Name "Sarah Jones" -DeviceTable @{"Cell"= 'sms:206555213'; "Command" = $CommandChannel.Name }

Related topics

 
Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft