Get-CisService

This cmdlet retrieves PSObject objects that represent a proxy to a vSphere Automation SDK API service and can be used to invoke the operations of that vSphere Automation SDK API service. The cmdlet returns one PSObject object for every service available on the vSphere Automation SDK server.

Syntax

[-Name  <String[]>]
[-Server  <CisServer[]>]
[CommonParameters]

Parameters

Required Parameter Name Type Position Features Description
optional
Name
String[] named
  • wildcards
  • Specifies the service type ID.
    optional
    Server
    CisServer[] named Specifies the vSphere Automation SDK servers on which you want to run the cmdlet. If no value is provided or $null value is passed to this parameter, the command runs on the default servers. For more information about default servers, see the description of Connect-CisServer.

    Output

    System.Management.Automation.PSObject

    Examples


    Example 1

    Get-CisService -Name 'com.vmware.cis.tagging.tag'

    Retrieves the binding for the specified service.

    Example 2

    # Connect to the vSphere Automation SDK API
    Connect-CisServer -Server $serverAddress -User $user -Password $pass
    # Get the service for VM management
    $vmService = Get-CisService com.vmware.vcenter.VM
    # Create a VM creation specification
    $createSpec = $vmService.Help.create.spec.Create()
    # Fill in the creation details
    $createSpec.name = "ExampleVM"
    $createSpec.guest_OS = "WINDOWS_7_64"
    # Create a placement specification
    $createSpec.placement = $vmService.Help.create.spec.placement.Create()
    # Fill in the placement details
    $createSpec.placement.folder = (Get-Folder vm).ExtensionData.MoRef.Value
    $createSpec.placement.host = (Get-VMHost)[0].ExtensionData.MoRef.Value
    $createSpec.placement.datastore = (Get-Datastore)[0].ExtensionData.MoRef.Value
    # Call the create method passing the specification
    $vmService.create( $createSpec )

    Connects to a vSphere Automation SDK server, retrieves the service for virtual machine management, and creates a virtual machine, based on the provided creation details by passing the specification to the create method.

    Related Commands

    Feedback

    Was this page helpful?