New-SCOpsMgrConnection
Applies To: System Center 2012 - Virtual Machine Manager
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 System Center Virtual Machine Manager (VMM) management server that you are currently connected to and a System Center 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
For more information about New-SCOpsMgrConnection, type: "Get-Help New-SCOpsMgrConnection -online".
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.
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
1: Create a connection to an Operations Manager management server.
The first command gets the Run As account object named OpsMgrServerAccount and 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 to for credentials, and 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