VMware vApp Discovery

Community.VMware.Discovery.vApp (Discovery)

PowerShell script that connects to vCenter to discover vApps

Element properties:

Object Discovery Details:

Member Modules:

Source Code:

<Discovery ID="Community.VMware.Discovery.vApp" Target="Community.VMware.Class.vCenter" Enabled="true" ConfirmDelivery="false" Remotable="true" Priority="Normal">

  <Category>Discovery</Category>

  <DiscoveryTypes>

    <DiscoveryClass TypeID="Community.VMware.Class.vApp"/>

    <DiscoveryRelationship TypeID="Community.VMware.Relationship.vCenterHostsvApp"/>

  </DiscoveryTypes>

  <DataSource ID="DS" TypeID="Windows!Microsoft.Windows.TimedPowerShell.DiscoveryProvider" RunAs="Community.VMware.SecureReference.RunAsProfile">

    <IntervalSeconds>14400</IntervalSeconds>

    <SyncTime>00:30</SyncTime>

    <ScriptName>Community.VMware.Discovery.vApp.ps1</ScriptName>

    <ScriptBody><Script>param($sourceId,$managedEntityId,$vCenterServerName)



Function ExitPrematurely ($Message) {

	$discoveryData.IsSnapshot = $false

	$api.LogScriptEvent($ScriptName,1985,2,$Message)

	$discoveryData

	exit

}



Function LogScriptEvent {

	Param (

		

		#0 = Informational

		#1 = Error

		#2 = Warning

		[parameter(Mandatory=$true)]

		[ValidateRange(0,2)]

		[int]$EventLevel

		,

		

		[parameter(Mandatory=$true)]

		[string]$Message

	)



	$api.LogScriptEvent($ScriptName,1985,$EventLevel,$Message)

}



Function DefaultErrorLogging {

	LogScriptEvent -EventLevel 1 -Message ("$_`rType:$($_.Exception.GetType().FullName)`r$($_.InvocationInfo.PositionMessage)`rReceivedParam:`rsourceId:$sourceId`rmanagedEntityId:$managedEntityId`rvCenterServerName:$vCenterServerName")

}



$ScriptName = 'Community.VMware.Discovery.vApp.ps1'

$api = new-object -comObject 'MOM.ScriptAPI'

$discoveryData = $api.CreateDiscoveryData(0, $sourceId, $managedEntityId)



Try {

	Add-PSSnapin VMware.VimAutomation.Core

} Catch {

	Start-Sleep -Seconds 10

	Try {

		Add-PSSnapin VMware.VimAutomation.Core

	} Catch {

		DefaultErrorLogging

		Exit

	}

}



Try {

	$connection = Connect-VIServer -Server $vCenterServerName -Force:$true -NotDefault

} Catch {

	Start-Sleep -Seconds 10

	Try {

		$connection = Connect-VIServer -Server $vCenterServerName -Force:$true -NotDefault

	} Catch {

		DefaultErrorLogging

	}

}



If ($connection.IsConnected -ne $True){

	ExitPrematurely ("Unable to connect to vCenter server " + $vCenterServerName)

}



Try {$VMvApps = Get-vApp -Server $connection | Select Name,Id}

Catch {DefaultErrorLogging}



If (!$VMvApps){

	Try {Disconnect-VIServer -Server $connection -Confirm:$false}

	Catch {DefaultErrorLogging}

	ExitPrematurely ("No vApps found in vCenter " + $vCenterServerName)

}



ForEach ($vApp in $VMvApps){



	#vApp Obj

	$vAppObj = $discoveryData.CreateClassInstance("$MPElement[Name='Community.VMware.Class.vApp']$")

	$vAppObj.AddProperty("$MPElement[Name='Community.VMware.Class.vApp']/vAppName$", $vApp.Name )

	$vAppObj.AddProperty("$MPElement[Name='Community.VMware.Class.vApp']/vAppId$", $vApp.Id )

	$vAppObj.AddProperty("$MPElement[Name='Community.VMware.Class.vCenter']/vCenterServerName$", $vCenterServerName)

	$vAppObj.AddProperty("$MPElement[Name='System!System.Entity']/DisplayName$", $vApp.Name )

	$discoveryData.AddInstance($vAppObj)

	

	#vCenter Obj (already discovered)

	$vCenterObj = $discoveryData.CreateClassInstance("$MPElement[Name='Community.VMware.Class.vCenter']$")

	$vCenterObj.AddProperty("$MPElement[Name='Community.VMware.Class.vCenter']/vCenterServerName$", $vCenterServerName )



	#vCenter Hosts vApp

	$rel1 = $discoveryData.CreateRelationshipInstance("$MPElement[Name='Community.VMware.Relationship.vCenterHostsvApp']$")

	$rel1.Source = $vCenterObj

	$rel1.Target = $vAppObj

	$discoveryData.AddInstance($rel1)

}

Try {Disconnect-VIServer -Server $connection -Confirm:$false}

Catch {DefaultErrorLogging}

$discoveryData</Script></ScriptBody>

    <Parameters>

      <Parameter>

        <Name>sourceID</Name>

        <Value>$MPElement$</Value>

      </Parameter>

      <Parameter>

        <Name>managedEntityID</Name>

        <Value>$Target/Id$</Value>

      </Parameter>

      <Parameter>

        <Name>vCenterServerName</Name>

        <Value>$Target/Property[Type="Community.VMware.Class.vCenter"]/vCenterServerName$</Value>

      </Parameter>

    </Parameters>

    <TimeoutSeconds>300</TimeoutSeconds>

  </DataSource>

</Discovery>