Deploying the OMS Agent Automatically

I needed to deploy a new OMS workspace to every machine in my environment and these machines were at various states of configuration. Some had the OMS agent already installed, some had various workspaces already added and some had the new OMS workspace already configured. Additionally these machines were in different environments with differing access to file services where the agent could be stored.

Therefore I created a script that downloads the agent from the Internet if its not already installed, checks if the desired workspace is already configured and adds if its not.

Update the workspace ID and Key to that of your environment.

#OMSInstallCSE.ps1   John Savill 
 
#Check if OMS Agent is installed
$MMAObj = Get-WmiObject -Class Win32_Product -Filter "name='Microsoft Monitoring Agent'"
 
#If the agent is not installed then install it
if($MMAObj -eq $null)
{
    $OMS64bitDownloaURL = "https://go.microsoft.com/fwlink/?LinkId=828603"
    $OMSDownloadPath = "c:Temp"
    $OMSDownloadFileName = "MMASetup-AMD64.exe"
    $OMSDownloadFullPath = "$OMSDownloadPath$OMSDownloadFileName"
 
    #Create temporary folder if it does not exist
    if (-not (Test-Path $OMSDownloadPath)) { New-Item -Path $OMSDownloadPath -ItemType Directory | Out-Null }
 
    Write-Output "Downloading the agent..."
 
    #Download to the temporary folder
    Invoke-WebRequest -Uri $OMS64bitDownloaURL -OutFile $OMSDownloadFullPath | Out-Null
 
    Write-Output "Installing the agent..."
 
    #Install the agent
    $ArgumentList = '/C:"setup.exe /qn ADD_OPINSIGHTS_WORKSPACE=0 AcceptEndUserLicenseAgreement=1"'
    Start-Process $OMSDownloadFullPath -ArgumentList $ArgumentList -ErrorAction Stop -Wait | Out-Null
}
 
#Add the CSE Workspace
$WorkspaceID = 'IDofWorkspace'
$WorkspaceKey = 'KeyofWorkspace'
 
#Check if the CSE workspace is already configured
$AgentCfg = New-Object -ComObject AgentConfigManager.MgmtSvcCfg
$OMSWorkspaces = $AgentCfg.GetCloudWorkspaces()
 
$CSEWorkspaceFound = $false
foreach($OMSWorkspace in $OMSWorkspaces)
{
    if($OMSWorkspace.workspaceId -eq $WorkspaceID)
    {
        $CSEWorkspaceFound = $true
    }
}
 
if(!$CSEWorkspaceFound)
{
    Write-Output "Adding CSE OMS Workspace..."
    $AgentCfg.AddCloudWorkspace($WorkspaceID,$WorkspaceKey)
    Restart-Service HealthService
}
else
{
    Write-Output "CSE OMS Workspace already configured"
}
 
# Get all configured OMS Workspaces
$AgentCfg.GetCloudWorkspaces()