New-SCOMConfigurationItemConnector

Creates an Operations Manager configuration item connector in Service Manager.

Syntax

New-SCOMConfigurationItemConnector [-DisplayName] <String> [[-Description] <String>] [-ComputerName <String[]>]
 [-Confirm] [-Credential <PSCredential>] [-Enable <Boolean>] [-ManagementPack <String[]>]
 -OperationsManagerServer <String> [-PassThru] [-RunAsAccount <ManagementPackSecureReference>]
 -SCOMCredential <PSCredential> [-SCSession <Connection[]>] [-ScheduleDay <DaySchedule>]
 [-ScheduleHour <Int32>] [-SyncNow] [-WhatIf] [<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:String[]
Required:False
Position:Named
Default value:Localhost
Accept pipeline input:False
Accept wildcard characters:False
-Confirm

Prompts you for confirmation before running the cmdlet.

Type:SwitchParameter
Aliases:cf
Required:False
Position:Named
Default value: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:PSCredential
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Description

Specifies a description for the connector.

Type:String
Required:False
Position:1
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-DisplayName

Specifies the name of the connector.

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

Indicates whether this cmdlet enables or disables the connector.

Type:Boolean
Required:False
Position:Named
Default value:True
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:String[]
Required:False
Position:Named
Default value:The default management pack
Accept pipeline input:False
Accept wildcard characters:False
-OperationsManagerServer

Specifies the name of the Operations Manager server.

Type:String
Required:True
Position:Named
Default value:None
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:SwitchParameter
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-RunAsAccount

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

Type:ManagementPackSecureReference
Required:False
Position:Named
Default value:WorkFlow RunAsAccount
Accept pipeline input:False
Accept wildcard characters:False
-SCOMCredential

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

Type:PSCredential
Required:True
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-SCSession

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

Type:Connection[]
Required:False
Position:Named
Default value:None
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:DaySchedule
Parameter Sets:Daily, Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday
Required:False
Position:Named
Default value:None
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:Int32
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-SyncNow

Initiates synchronization of the Operations Manager configuration item connector.

Type:SwitchParameter
Required:False
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
Required:False
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False

Inputs

None.

You cannot pipe input to this cmdlet.

Outputs

None.

This cmdlet does not generate any output.