Connect-OMServer

This cmdlet establishes a connection to the vRealize Operations Manager server specified by the -Server parameter.

Syntax

-Server  <String[]>
[-AuthSource  <String>]
[-Force]
[-NotDefault]
[-Password  <SecureString>]
[-Port  <Int32>]
[-SaveCredentials]
[-User  <String>]
[CommonParameters]

Parameters

Required Parameter Name Type Position Features Description
required
Server
String[] named Specifies the IP or DNS addresses of the vRealize Operations Manager servers you want to connect to.
optional
AuthSource
String named Specifies the authentication source type. The default authentication source type value is LocalUser. You can specify ActiveDirectory, OpenLDAP, or VC as authentication source type values.
optional
Force
SwitchParameter named Suppresses all user interface prompts during the cmdlet execution.
optional
NotDefault
SwitchParameter named Specifies that you do not want to save the specified servers as default servers.
optional
Password
SecureString named Specifies the password you want to use for authenticating with the server. For more information about the server authentication logic of PowerCLI, run "help about_server_authentication". Note: If the password contains special characters, enclose the entire string in single quotes (').
optional
Port
Int32 named Specifies the port on the server you want to use for the connection. If not specified, the default port value is 443.
optional
SaveCredentials
SwitchParameter named Indicates that you want to save the specified credentials in the local credential store.
optional
User
String named Specifies the user name you want to use for authenticating with the server. For more information about the server authentication logic of PowerCLI, run "help about_server_authentication". Note: If the user name contains special characters, enclose the entire string in single quotes (').

-Credential  <PSCredential>
-Server  <String[]>
[-AuthSource  <String>]
[-Force]
[-NotDefault]
[-Port  <Int32>]
[-SaveCredentials]
[CommonParameters]

Parameters

Required Parameter Name Type Position Features Description
required
Credential
PSCredential named
  • pipeline
  • Specifies a PSCredential object that contains credentials for authenticating with the server. For more information about the server authentication logic of PowerCLI, run "help about_server_authentication".
    required
    Server
    String[] named Specifies the IP or DNS addresses of the vRealize Operations Manager servers you want to connect to.
    optional
    AuthSource
    String named Specifies the authentication source type. The default authentication source type value is LocalUser. You can specify ActiveDirectory, OpenLDAP, or VC as authentication source type values.
    optional
    Force
    SwitchParameter named Suppresses all user interface prompts during the cmdlet execution.
    optional
    NotDefault
    SwitchParameter named Specifies that you do not want to save the specified servers as default servers.
    optional
    Port
    Int32 named Specifies the port on the server you want to use for the connection. If not specified, the default port value is 443.
    optional
    SaveCredentials
    SwitchParameter named Indicates that you want to save the specified credentials in the local credential store.

    -Menu
    [CommonParameters]

    Parameters

    Required Parameter Name Type Position Features Description
    required
    Menu
    SwitchParameter named Indicates that you want to select a connection server from a list of recently connected servers. If Menu is provided, the cmdlet retrieves a list of the last visited servers and enters a nested command prompt, so that you can select a server from the list.

    -Server  <String[]>
    -SessionSecret  <String>
    [-Force]
    [-NotDefault]
    [-Port  <Int32>]
    [CommonParameters]

    Parameters

    Required Parameter Name Type Position Features Description
    required
    Server
    String[] named Specifies the IP or DNS addresses of the vRealize Operations Manager servers you want to connect to.
    required
    SessionSecret
    String named Specifies the ID of an existing vRealize Operations Manager session you want to reestablish.
    optional
    Force
    SwitchParameter named Suppresses all user interface prompts during the cmdlet execution.
    optional
    NotDefault
    SwitchParameter named Specifies that you do not want to save the specified servers as default servers.
    optional
    Port
    Int32 named Specifies the port on the server you want to use for the connection. If not specified, the default port value is 443.

    Output

    VMware.VimAutomation.vROps.Types.V1.OMServer

    Examples


    Example 1

    Connect-OMServer -Server 'server_name' -User 'user_name' -Password 'user_password'

    Connects to a vRealize Operations Manager server by using the User and Password parameters.

    Example 2

    Connect-OMServer -Server 'server_name' -AuthSource 'vCenterServer_name_in_vROps' -User 'vCenterServer_admin' -Password 'user_password'

    Connects to a vRealize Operations Manager server as a vCenter Server user, imported from the monitored vCenter Server system.

    Example 3

    $srv = Connect-OMServer 'server_name' -User 'admin' -Password 'user_password'
    Connect-OMServer 'server_name' -Session $srv.SessionId

    Connects to a vRealize Operations Manager server with an existing session.

    Example 4

    $secpasswd = ConvertTo-SecureString 'PlainTextPassword' -AsPlainText -Force
    $mycreds = New-Object System.Management.Automation.PSCredential ('user_name', $secpasswd)
    Connect-OMServer 'server_name' -Credential $mycreds

    Connects to a vRealize Operations server by using a credentials object.

    Related Commands

    Feedback

    Was this page helpful?