New-SCOMConfigurationItemConnector

Reference

Module:: System.Center.Service.Manager

Creates a new Operations Manager CI connector in Service Manager.

Syntax

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

Description

The New-SCOMConfigurationItemConnector cmdlet creates an Operations Manager configuration item connector in Service Manager.

Examples

Example 1: Create a configuration item connector

PS C:\>$RunAsAccount = Get-SCSMRunAsAccount -DisplayName "Workflow"
PS C:\> New-SCOMConfigurationItemConnector -DisplayName "WOODGROVE OpsMgr CI CONNECTOR" -Description "Woodgrove Operations Manager CI connection" -OperationsManagerServer "OpsMgrServer" -Enable $True -ManagementPack "Microsoft.Windows.Server.2003","Microsoft.Windows.Library" -RunAsAccount $RunAsAccount -ScheduleHour 1

The first command gets a Run As account for Workflow Account by using the Get-SCSMRunAsAccount cmdlet. The command stores the result in the $RunAsAccount variable.

The second command creates an Operations Manager configuration item connector to the database server named OpsMgrServer. This connector is configured to synchronize every day at 1:00 am.

Parameters

-ComputerName

Specifies the name of the computer on which the System Center Data Access service runs. The user account that is specified in the Credential parameter must have access rights to the specified computer.

Type:	System.String[]
Position:	Named
Default value:	Localhost
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

Prompts you for confirmation before running the cmdlet.

Type:	System.Management.Automation.SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Credential

Specifies the credentials that this cmdlet uses to connect to the server on which the System Center Data Access service runs. The specified user account must have access rights to that server.

Type:	PSCredentialSystem.Management.Automation.PSCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Description

Specifies a description for the connector.

Type:	System.String
Position:	1
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DisplayName

Specifies the name of the connector.

Type:	System.String
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Enable

Indicates whether this cmdlet enables or disables the connector.

Type:	System.Boolean
Position:	Named
Default value:	True
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ManagementPack

Specifies the management pack in which to store the Operations Manager configuration item connector. You cannot specify a sealed management pack.

Type:	System.String[]
Position:	Named
Default value:	The default management pack
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-OperationsManagerServer

Specifies the name of the Operations Manager server.

Type:	System.String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-PassThru

Indicates that this cmdlet returns the Operations Manager configuration item connector that it creates. You can pass this object to other cmdlets.

Type:	System.Management.Automation.SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-RunAsAccount

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

Type:	Microsoft.EnterpriseManagement.Configuration.ManagementPackSecureReference
Position:	Named
Default value:	WorkFlow RunAsAccount
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ScheduleDay

Specifies the day of the week in which to synchronize the connector. Valid values are:

Daily
Sunday
Monday
Tuesday
Wednesday
Thursday
Friday
Saturday

Type:	Microsoft.EnterpriseManagement.ServiceManager.Sdk.Connectors.DaySchedule
Accepted values:	Daily, Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ScheduleHour

Specifies the hour at which the connector starts synchronization. The value must be a number from zero (0) to 23.

Type:	System.Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SCOMCredential

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

Type:	System.Management.Automation.PSCredential
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-SCSession

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

Type:	Microsoft.SystemCenter.Core.Connection.Connection[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SyncNow

Initiates synchronization of the Operations Manager configuration item connector.

Type:	System.Management.Automation.SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

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

Type:	System.Management.Automation.SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Inputs

None.

You cannot pipe input to this cmdlet.

Outputs