This topic has not yet been rated - Rate this topic

New-SCOMConfigurationItemConnector

Updated: January 14, 2013

Applies To: System Center 2012 - Service Manager, System Center 2012 SP1 - Service Manager

New-SCOMConfigurationItemConnector

Creates a new Operations Manager CI connector in Service Manager.

Syntax

Parameter Set: Default
New-SCOMConfigurationItemConnector [-DisplayName] <String> [[-Description] <String> ] -OperationsManagerServer <String> -SCOMCredential <PSCredential> [-ComputerName <String[]> ] [-Credential <PSCredential> ] [-Enable <Boolean> ] [-ManagementPack <String[]> ] [-PassThru] [-RunAsAccount <ManagementPackSecureReference> ] [-ScheduleDay <DaySchedule> ] [-ScheduleHour <Int32> ] [-SCSession <Connection[]> ] [-SyncNow] [-Confirm] [-WhatIf] [ <CommonParameters>]

Detailed Description

The New-SCOMConfigurationItemConnector cmdlet creates a new Operations Manager CI connector in Service Manager.

Parameters

-ComputerName<String[]>

Specifies the name of the computer on which the System Center Data Access service runs.

Aliases	none
Required?	false
Position?	named
Default Value	localhost
Accept Pipeline Input?	true (ByValue)
Accept Wildcard Characters?	false

-Credential<PSCredential>

Specifies the credential to use when you connect to the management server.

Aliases	none
Required?	false
Position?	named
Default Value	none
Accept Pipeline Input?	true (ByValue)
Accept Wildcard Characters?	false

-Description<String>

Provides unique descriptive text for the connector.

Aliases	none
Required?	false
Position?	2
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-DisplayName<String>

Specifies the name of the connector.

Aliases	none
Required?	true
Position?	1
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-Enable<Boolean>

Enables or disables the connector.

Aliases	none
Required?	false
Position?	named
Default Value	True
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-ManagementPack<String[]>

Specifies the management pack in which to store the new Operations Manager CI connector. If the specified management pack is sealed, a terminating error of InvalidOperation is generated.

Aliases	none
Required?	false
Position?	named
Default Value	the default management pack
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-OperationsManagerServer<String>

Specifies the name of the Operations Manager server.

Aliases	none
Required?	true
Position?	named
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-PassThru

Specifies the output object that represents the new Operations Manager CI connector. This output object can be passed to other cmdlets.

Aliases	none
Required?	false
Position?	named
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-RunAsAccount<ManagementPackSecureReference>

Specifies the Run As account to use during the synchronization of the connector.

Aliases	none
Required?	false
Position?	named
Default Value	WorkFlow RunAsAccount
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-SCOMCredential<PSCredential>

Specifies the credential to use when you connect to the Operations Manager server.

Aliases	none
Required?	true
Position?	named
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-SCSession<Connection[]>

Specifies an object that represents a session to a Service Manager management server.

Aliases	none
Required?	false
Position?	named
Default Value	none
Accept Pipeline Input?	true (ByValue)
Accept Wildcard Characters?	false

-ScheduleDay<DaySchedule>

Specifies the day of the week in which to synchronize the connector. Allowed values are All, Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, and Saturday.

Aliases	none
Required?	false
Position?	named
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-ScheduleHour<Int32>

Specifies the hour at which to start synchronizing the connector. The value is an integer between 0-23.

Aliases	none
Required?	false
Position?	named
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-SyncNow

Initiates synchronization of the Operations Manager CI connector.

Aliases	none
Required?	false
Position?	named
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-Confirm

Prompts you for confirmation before executing the command.

Required?	false
Position?	named
Default Value	false
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-WhatIf

Describes what would happen if you executed the command without actually executing the command.

Required?	false
Position?	named
Default Value	false
Accept Pipeline Input?	false
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.

None.
You cannot pipe input to this cmdlet.

Outputs

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

None.
This cmdlet does not generate any output.

Examples

-------------------------- EXAMPLE 1 --------------------------

This script creates an Operations Manager CI connector to the database Server OpsMgrServer. This connector is configured to synchronize every day at 1:00 am.

PowerShell

PS C:\>$RA = Get-SCSMRunAsAccount Workflow
PS C:\>$arguments = @{
>>  Name = "WOODGROVE OpsMgr CI CONNECTOR"
>>  Description = "Descriptive text for my configuration manager connector"
>>  RunAs = $RA
>>  Enable = $true
>>  OperationsManagerServer = "OpsMgrServer"
>>  ManagementPack =  "Microsoft.Windows.Server.2003","Microsoft.Windows.Library"
>>  ScheduleHour = 1
>>  }
PS C:\>New-SCOMConfigurationItemConnector @arguments

Did you find this helpful? Yes No

Not accurate

Not enough depth

Need more code examples

(1500 characters remaining)