New-SCOMConfigurationItemConnector

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 running the cmdlet.

Required?

false

Position?

named

Default Value

false

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-WhatIf

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

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 (https://go.microsoft.com/fwlink/p/?LinkID=113216).

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.

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