New-SCOpsMgrConnection

New-SCOpsMgrConnection

Creates a connection to an Operations Manager management group.

Syntax

Parameter Set: Default
New-SCOpsMgrConnection -OpsMgrServer <String> -VMMServerCredential <PSCredential> [-EnableMaintenanceModeIntegration <Boolean]> ] [-EnablePRO <Boolean> ] [-JobVariable <String> ] [-OpsMgrServerCredential <RunAsAccount> ] [-PROTipID <Guid]> ] [-RunAsynchronously] [-UseVMMServerServiceAccount] [-VMMServer <ServerConnection> ] [ <CommonParameters>]

Detailed Description

The New-SCOpsMgrConnection cmdlet creates a connection between the Virtual Machine Manager (VMM) management server that you are currently connected to and an Operations Manager management group.

Before creating a connection to an Operations Manager management server, you must install the Operations Manager management console on your VMM management server and install the following management packs in Operations Manager:

-- SQL Server Core Library version 6.0.5000.0 or later management pack
-- Windows Server Internet Information Services Library version 6.0.5000.0 or later management pack
-- Windows Server Internet Information Services 2003 version 6.0.5000.0 or later management pack
-- Windows Server Internet Information Services 7 version 6.0.6539.0 or later management pack

Parameters

-EnableMaintenanceModeIntegration<Boolean]>

Indicates whether maintenance mode integration is enabled for this connection.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-EnablePRO<Boolean>

Indicates whether PRO is enabled for this connection.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-JobVariable<String>

Specifies that job progress is tracked and stored in the variable named by this parameter.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-OpsMgrServer<String>

Specifies the fully qualified domain name (FQDN) of the System Center Operations Manager management server to which VMM connects.

Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-OpsMgrServerCredential<RunAsAccount>

Specifies the credentials that VMM uses to connect to the Operations Manager management group.The specified account must be an administrator on the Operations Manager computer (a member of the Builtin\Administrators group).

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-PROTipID<Guid]>

Specifies the ID of the PRO tip that triggered this action. This allows for auditing of PRO tips.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-RunAsynchronously

Indicates that the job runs asynchronously so that control returns to the command shell immediately.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-UseVMMServerServiceAccount

Specifies the service account that VMM uses to connect to Operations Manager.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-VMMServer<ServerConnection>

Specifies a VMM server object.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByValue)

Accept Wildcard Characters?

false

-VMMServerCredential<PSCredential>

Specifies the credentials that Operations Manager uses to connect with VMM.

Aliases

none

Required?

true

Position?

named

Default Value

none

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.

Outputs

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

  • OpsMgrConnection

Examples

Example 1: Create a connection to an Operations Manager management server

The first command gets the Run As account object named OpsMgrServerAccount, and then stores the object in the $OMCreds variable. The credentials provided in the Run As account must be a member of the Administrators user role on the Operations Manager management server.

The second command prompts you for credentials, and then stores the credentials you provide in the $VMMCreds variable. The account you provide must be a member of the Administrator user role on the VMM management server.

The last command creates a connection between the VMM management server that you are currently connected to and OpsMgrServer01 using the credentials obtained in the first two commands.

PS C:\> $OMCreds = Get-SCRunAsAccount -Name "OpsMgrServerAccount"
PS C:\> $VMMCreds = Get-Credential
PS C:\> New-SCOpsMgrConnection -OpsMgrServer "OpsMgrServer01.Contoso.com" -OpsMgrServerCredential $OMCreds -VMMServerCredential $VMMCreds

Get-SCOpsMgrConnection

Remove-SCOpsMgrConnection

Set-SCOpsMgrConnection

Write-SCOpsMgrConnection

Get-SCRunAsAccount