From 493efa1211765999dd110de75b00d06c90f9a56a Mon Sep 17 00:00:00 2001
From: Antonio B <antonioblancocpe@gmail.com>
Date: Fri, 18 Nov 2016 15:08:14 -0800
Subject: [PATCH] add powershell sdk

---
 .../PSApplicationInsights.psd1                |  79 +++++
 .../PSApplicationInsights.psm1                | 296 ++++++++++++++++++
 .../about_PSApplicationInsights.help.txt      |  26 ++
 PSApplicationInsights/README.md               | Bin 0 -> 8518 bytes
 .../Tests/PSApplicationInsights.tests.ps1     | 106 +++++++
 PSApplicationInsights/build.ps1               |  13 +
 .../PSApplicationInsightsExamples.ps1         |  82 +++++
 PSApplicationInsights/packages.config         |   4 +
 8 files changed, 606 insertions(+)
 create mode 100644 PSApplicationInsights/PSApplicationInsights/PSApplicationInsights.psd1
 create mode 100644 PSApplicationInsights/PSApplicationInsights/PSApplicationInsights.psm1
 create mode 100644 PSApplicationInsights/PSApplicationInsights/en-US/about_PSApplicationInsights.help.txt
 create mode 100644 PSApplicationInsights/README.md
 create mode 100644 PSApplicationInsights/Tests/PSApplicationInsights.tests.ps1
 create mode 100644 PSApplicationInsights/build.ps1
 create mode 100644 PSApplicationInsights/examples/PSApplicationInsightsExamples.ps1
 create mode 100644 PSApplicationInsights/packages.config

diff --git a/PSApplicationInsights/PSApplicationInsights/PSApplicationInsights.psd1 b/PSApplicationInsights/PSApplicationInsights/PSApplicationInsights.psd1
new file mode 100644
index 0000000..0d7aeaa
--- /dev/null
+++ b/PSApplicationInsights/PSApplicationInsights/PSApplicationInsights.psd1
@@ -0,0 +1,79 @@
+@{
+  # Root Module
+  RootModule = 'PSApplicationInsights.psm1'
+
+  # Version Number
+  ModuleVersion = '1.0'
+
+  # Unique Module ID
+  GUID = '3ea2fc69-50e2-4c25-95ae-89164ef9b388'
+
+  # Module Author
+  Author = 'Antonio Blanco'
+
+  # Company
+  CompanyName = ''
+
+  # Copyright
+  Copyright = ''
+
+  # Module Description
+  Description = 'PowerShell wrapper for Microsoft Application Insights'
+
+  # Minimum PowerShell Version Required
+  PowerShellVersion = '2.0'
+
+  # Name of Required PowerShell Host
+  #PowerShellHostName = ''
+
+  # Minimum Host Version Required
+  #PowerShellHostVersion = ''
+
+  # Minimum .NET Framework-Version
+  DotNetFrameworkVersion = '4.5'
+
+  # Minimum CLR (Common Language Runtime) Version
+  #CLRVersion = ''
+
+  # Processor Architecture Required (X86, Amd64, IA64)
+  #ProcessorArchitecture = ''
+
+  # Required Modules (will load before this module loads)
+  RequiredModules = @()
+
+  # Required Assemblies
+  RequiredAssemblies = @()
+
+  # PowerShell Scripts (.ps1) that need to be executed before this module loads
+  ScriptsToProcess = @()
+
+  # Type files (.ps1xml) that need to be loaded when this module loads
+  TypesToProcess = @()
+
+  # Format files (.ps1xml) that need to be loaded when this module loads
+  FormatsToProcess = @()
+
+  # 
+  NestedModules = @()
+
+  # List of exportable functions
+  FunctionsToExport = @('New-TelemetryClient')
+
+  # List of exportable cmdlets
+  #CmdletsToExport = '*'
+
+  # List of exportable variables
+  #VariablesToExport = '*'
+
+  # List of exportable aliases
+  #AliasesToExport = '*'
+
+  # List of all modules contained in this module
+  #ModuleList = @()
+
+  # List of all files contained in this module
+  #FileList = @()
+
+  # Private data that needs to be passed to this module
+  #PrivateData = ''
+}
\ No newline at end of file
diff --git a/PSApplicationInsights/PSApplicationInsights/PSApplicationInsights.psm1 b/PSApplicationInsights/PSApplicationInsights/PSApplicationInsights.psm1
new file mode 100644
index 0000000..eb0ddf4
--- /dev/null
+++ b/PSApplicationInsights/PSApplicationInsights/PSApplicationInsights.psm1
@@ -0,0 +1,296 @@
+function ConvertTo-Dictionary
+{
+  #requires -Version 2.0
+
+  param (
+    [Parameter(Mandatory = $true, ValueFromPipeline = $true)]
+    [hashtable]
+    $InputObject,
+    [Parameter(Mandatory = $true)]
+    [Type]$ValueType 
+  )
+
+  process
+  {
+    $outputObject = New-Object -TypeName "System.Collections.Generic.Dictionary[[string],[$($ValueType.FullName)]]]"
+
+    foreach ($entry in $InputObject.GetEnumerator())
+    {
+      $newKey = $entry.Key -as [string]
+            
+      if ($null -eq $newKey)
+      {
+        $message = 'Could not convert key "{0}" of type "{1}" to type "{2}"'-f
+        $entry.Key,
+        $entry.Key.GetType().FullName,
+        [string].FullName
+
+        Write-Warning -Message $message
+      }
+      elseif ($outputObject.ContainsKey($newKey))
+      {
+        Write-Warning -Message "Duplicate key `"$newKey`" detected in input object."
+      }
+
+      $outputObject.Add($newKey, $entry.Value)
+    }
+
+    Write-Output -InputObject $outputObject
+  }
+}
+
+function New-TrackEventOverload
+{
+  param(
+    [Parameter(Mandatory=$true)]
+    $TrackEventDelegate
+  )
+ 
+  # When we add a script method, the scope becomes the current user scope instead of the module scope
+  # Because of this, our private function ConvertTo-Dictionary is not available in the user scope. 
+  
+  # To avoid this, we can create a closure over the local variable which has the function definition  
+  $convertToDictionaryFunc = ${function:ConvertTo-Dictionary}  
+  return {
+    param(
+      [Parameter(Mandatory=$true)]
+      [string] $EventName,
+      [AllowNull()]
+      [hashtable] $Properties, 
+      [AllowNull()]
+      [hashtable] $Metrics
+    )
+
+    $propertiesDictionary = $Properties | & $convertToDictionaryFunc -ValueType string
+    $metricsDictionary = $Metrics | & $convertToDictionaryFunc -ValueType double
+ 
+    $TrackEventDelegate.Invoke($EventName, $propertiesDictionary, $metricsDictionary)
+  }.GetNewClosure()
+}
+
+function New-TrackMetricOverload
+{
+  param(
+    [Parameter(Mandatory=$true)]
+    $TrackMetricDelegate
+  )
+ 
+  # When we add a script method, the scope becomes the current user scope instead of the module scope
+  # Because of this, our private function ConvertTo-Dictionary is not available in the user scope. 
+  
+  # To avoid this, we can create a closure over the local variable which has the function definition  
+  $convertToDictionaryFunc = ${function:ConvertTo-Dictionary}  
+  return {
+    param(
+      [Parameter(Mandatory=$true)]
+      [string] $MetricName,
+      [Parameter(Mandatory=$true)]
+      [double] $Value,
+      [AllowNull()]
+      [hashtable] $Properties
+    )
+    $propertiesDictionary = $Properties | & $convertToDictionaryFunc -ValueType string
+
+    $TrackMetricDelegate.Invoke($MetricName, $Value, $propertiesDictionary)
+  }.GetNewClosure()
+}
+
+function New-TrackTraceOverload
+{
+  param(
+    [Parameter(Mandatory=$true)]
+    $TrackTraceDelegate
+  )
+ 
+  # When we add a script method, the scope becomes the current user scope instead of the module scope
+  # Because of this, our private function ConvertTo-Dictionary is not available in the user scope. 
+  
+  # To avoid this, we can create a closure over the local variable which has the function definition  
+  $convertToDictionaryFunc = ${function:ConvertTo-Dictionary}  
+  return {
+    param(
+      [Parameter(Mandatory=$true)]
+      [string] $Message,
+      [AllowNull()]
+      [string] $SeverityLevel, 
+      [AllowNull()]
+      [hashtable] $Properties
+    )
+    $propertiesDictionary = $Properties | & $convertToDictionaryFunc -ValueType string
+      
+    try {
+      $level = [Microsoft.ApplicationInsights.DataContracts.SeverityLevel]($SeverityLevel)
+      $TrackTraceDelegate.Invoke($Message, $level, $propertiesDictionary)
+    } 
+    catch {
+      Write-Warning -Message "Application Insights: No valid Severity Level was specified, using the default instead. Valid severity levels are 'Verbose','Information','Warning','Error','Critical'"
+     
+      $TrackTraceDelegate.Invoke($Message, $propertiesDictionary)
+    }
+  }.GetNewClosure()
+}
+
+function New-TrackExceptionOverload
+{
+  param(
+    [Parameter(Mandatory=$true)]
+    $TrackExceptionDelegate
+  )
+ 
+  # When we add a script method, the scope becomes the current user scope instead of the module scope
+  # Because of this, our private function ConvertTo-Dictionary is not available in the user scope. 
+  
+  # To avoid this, we can create a closure over the local variable which has the function definition  
+  $convertToDictionaryFunc = ${function:ConvertTo-Dictionary}  
+  return {
+    param(
+      [Parameter(Mandatory=$true)]
+      [Exception] $Exception,
+      [AllowNull()]
+      [hashtable] $Properties, 
+      [AllowNull()]
+      [hashtable] $Metrics
+    )
+    $propertiesDictionary = $Properties | & $convertToDictionaryFunc -ValueType string
+    $metricsDictionary = $Metrics | & $convertToDictionaryFunc -ValueType double
+ 
+    $TrackExceptionDelegate.Invoke($Exception, $propertiesDictionary, $metricsDictionary)
+  }.GetNewClosure()
+}
+
+function New-TelemetryClient
+{
+  <#
+      .SYNOPSIS
+      Creates a new instance of an Application Insights TelemetryClient
+
+      .DESCRIPTION
+      Creates a new instance of an Application Insights TelemetryClient that can be used in your PowerShell scripts.
+      Includes PowerShell overloads for using Hashtables for adding custom properties and custom metrics. 
+      Because this instance uses the InMemory channel, be sure to call the Flush() method to flush and send telemetry to App Insights.
+
+      .PARAMETER InstrumentationKey
+      The Application Insights Instrumentation Key
+
+      .EXAMPLE
+      Create a new telemetry client instance
+      $ai = New-TelemetryClient -InstrumentationKey "iKey"
+
+      .EXAMPLE
+      Track a event with custom properties
+      $ai = New-TelemetryClient -InstrumentationKey "iKey"
+      $ai.TrackEvent('event')
+
+      .EXAMPLE
+      Track a event with custom properties
+      $ai = New-TelemetryClient -InstrumentationKey "iKey"
+      $ai.TrackEvent('event', @{customProperty='a'})
+
+      .EXAMPLE
+      Track a event with custom properties and custom metrics
+      $ai = New-TelemetryClient -InstrumentationKey "iKey"
+      $ai.TrackEvent('event', @{customProperty='a'}, @{customMetric=3.0})
+
+      .EXAMPLE
+      Track a metric with custom properties
+      $ai = New-TelemetryClient -InstrumentationKey "iKey"
+      $ai.TrackMetric('metric', 1)
+
+      .EXAMPLE
+      Track a metric with custom properties
+      $ai = New-TelemetryClient -InstrumentationKey "iKey"
+      $ai.TrackMetric('metric', 1, @{customProperty='a'})
+
+      .EXAMPLE
+      Track a metric with custom properties and custom metrics
+      $ai = New-TelemetryClient -InstrumentationKey "iKey"
+      $ai.TrackMetric('metric', 1, @{customProperty='a'}, @{customMetric=3.0})
+
+      .EXAMPLE
+      Track a trace 
+      $ai = New-TelemetryClient -InstrumentationKey "iKey"
+      $ai.TrackTrace('trace')
+
+      .EXAMPLE
+      Track a trace with a severity level. Valid severity levels are 'Verbose','Information','Warning','Error','Critical'
+      $ai = New-TelemetryClient -InstrumentationKey "iKey"
+      $ai.TrackTrace('trace', 'verbose')
+
+      .EXAMPLE
+      Track a trace with a severity level and custom properties
+      $ai = New-TelemetryClient -InstrumentationKey "iKey"
+      $ai.TrackTrace('trace', 'verbose', @{customProperty='a'})
+
+      .EXAMPLE
+      Track a exception 
+      $ai = New-TelemetryClient -InstrumentationKey "iKey"
+      try{ 
+      throw 'exception'
+      } 
+      catch { 
+      $exception = $_.Exception
+      $tc.TrackException($exception)
+      }
+
+      .EXAMPLE
+      Track a exception with custom properties
+      $ai = New-TelemetryClient -InstrumentationKey "iKey"
+      try{ 
+      throw 'exception'
+      } 
+      catch { 
+      $exception = $_.Exception
+      $tc.TrackException($exception, @{customProperty='PowerShell!'})
+      }
+
+      .EXAMPLE
+      Track a exception with custom properties and custom metrics
+      $ai = New-TelemetryClient -InstrumentationKey "iKey"
+      try{ 
+      throw 'exception'
+      } 
+      catch { 
+      $exception = $_.Exception
+      $tc.TrackException($exception, @{'customProperty'='PowerShell!'}, @{customMetrics=3.0})   
+      }
+
+      .NOTES    
+      Author: Antonio Blanco (anblanco@microsoft.com)
+
+      .LINK
+      https://docs.microsoft.com/en-us/azure/application-insights/
+
+      .INPUTS
+      [System.String]
+
+      .OUTPUTS
+      [Microsoft.ApplicationInsights.TelemetryClient]
+  #>
+
+  param(
+    [Parameter(Mandatory=$true)]
+    [string] $InstrumentationKey
+  )
+
+  Add-Type -Path "$PSScriptRoot\microsoft.applicationinsights.2.2.0-beta4\lib\net45\Microsoft.ApplicationInsights.dll" 
+  $appInsights = New-Object -TypeName Microsoft.ApplicationInsights.TelemetryClient
+  $appInsights.InstrumentationKey = $InstrumentationKey 
+
+  #TrackEvent overload
+  $trackEvent = New-TrackEventOverload -TrackEventDelegate $appInsights.TrackEvent
+  $appInsights | Add-Member -MemberType ScriptMethod -Name TrackEvent -Value $trackEvent -Force
+
+  #TrackMetric overload
+  $trackMetric = New-TrackMetricOverload -TrackMetricDelegate $appInsights.TrackMetric
+  $appInsights | Add-Member -MemberType ScriptMethod -Name TrackMetric -Value $trackMetric -Force
+
+  #TrackTrace overload
+  $trackTrace = New-TrackTraceOverload -TrackTraceDelegate $appInsights.TrackTrace
+  $appInsights | Add-Member -MemberType ScriptMethod -Name TrackTrace -Value $trackTrace -Force
+
+  #TrackException overload
+  $trackException = New-TrackExceptionOverload -TrackExceptionDelegate $appInsights.TrackException
+  $appInsights | Add-Member -MemberType ScriptMethod -Name TrackException -Value $trackException -Force
+
+  Write-Output -InputObject $appInsights
+}
\ No newline at end of file
diff --git a/PSApplicationInsights/PSApplicationInsights/en-US/about_PSApplicationInsights.help.txt b/PSApplicationInsights/PSApplicationInsights/en-US/about_PSApplicationInsights.help.txt
new file mode 100644
index 0000000..3eaa90f
--- /dev/null
+++ b/PSApplicationInsights/PSApplicationInsights/en-US/about_PSApplicationInsights.help.txt
@@ -0,0 +1,26 @@
+PSTOPIC
+    about_PSApplicationInsights
+
+SHORT DESCRIPTION
+    PSApplicationInsights is a module that provides PowerShell friendly overloads for the core Application Insights SDK.
+
+LONG DESCRIPTION
+    PSApplicationInsights provides a new PowerShell cmdlet, New-TelemetryClient, and overloads existing Track* calls
+    to support Hashtables which have a more natual syntax in PowerShell. It is packaged as a single module with the latest
+    version of Application Insights and has working examples for all of the Track* calls. 
+
+DETAILED DESCRIPTION
+    PSApplicationInsights was written with two scenarios in mind
+    1) Allowing a PowerShell developer to more easily integrate PowerShell scripts and telemetry to existing apps
+
+    Example: A web app hosted in Azure with a SQL Azure backend is likely to have existing web app telemetry. 
+    This app may perform common automation tasks such as invoking a webhook as an alert rule, or scheduled scale up and 
+    scale down of the SQL Azure database. Using PSApplicationInsights one can quick add telemetry to these automation tasks 
+    from their scripts or runbooks, such as: 
+        TrackEvent('Sql Resize'. @{databaseName=$databaseName}, @{resizeTime=$duration.Seconds}).
+
+    2) Allowing PowerShell script authors to more easily instrument their scripts to track script and feature usage
+    
+    Example: Wouldn't it be nice to know what cmdlets get used the most? Or if users are actually using that 
+    alternate parameter set you defined? PSApplicationInsights makes it easy and natural to instrument your scripts 
+    using the Application Insights SDK
\ No newline at end of file
diff --git a/PSApplicationInsights/README.md b/PSApplicationInsights/README.md
new file mode 100644
index 0000000000000000000000000000000000000000..1efdd1da40500aa6ff67c827fbdcf510cb2d651c
GIT binary patch
literal 8518
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

literal 0
HcmV?d00001

diff --git a/PSApplicationInsights/Tests/PSApplicationInsights.tests.ps1 b/PSApplicationInsights/Tests/PSApplicationInsights.tests.ps1
new file mode 100644
index 0000000..9350e4d
--- /dev/null
+++ b/PSApplicationInsights/Tests/PSApplicationInsights.tests.ps1
@@ -0,0 +1,106 @@
+Import-Module $PSScriptRoot\..\PSApplicationInsights -Force
+
+Describe 'New-TelemetryClient' {
+
+  Context 'Constructor'   {
+    
+    It 'does not throw' {
+      { New-TelemetryClient -InstrumentationKey "iKey" } | Should Not Throw
+    }
+
+    It 'returns a new telemetry client'     {
+      New-TelemetryClient -InstrumentationKey "iKey" | Should BeOfType Microsoft.ApplicationInsights.TelemetryClient     
+    }
+
+    It 'sets the instrumentation key'     {
+      $sut = New-TelemetryClient -InstrumentationKey "iKey" 
+      $sut.InstrumentationKey | Should Be "iKey"
+    }
+  }
+
+  Context 'TrackEvent'   {
+    BeforeEach {$sut = New-TelemetryClient -InstrumentationKey "iKey" }
+
+    It 'tracks event with only event name' {
+      { $sut.TrackEvent('event',@{customProperty='a'}) } | Should Not Throw
+    }
+    It 'tracks event with custom properties' {
+      { $sut.TrackEvent('event',@{customProperty='a'}) } | Should Not Throw
+    }
+    It 'tracks event with custom properties and metrics' {
+      { $sut.TrackEvent('event',@{customProperty='a'}, @{customMetric=3.0}) } | Should Not Throw
+    }
+  }
+
+  Context 'TrackMetric' {
+    BeforeEach {$sut = New-TelemetryClient -InstrumentationKey "iKey" }
+
+    It 'tracks metric with only metric name' {
+      { $sut.TrackMetric('metric',1,@{customProperty='a'}) } | Should Not Throw
+    }
+    It 'tracks metric with custom properties' {
+      { $sut.TrackMetric('metric',1,@{customProperty='a'}) } | Should Not Throw
+    }
+    It 'tracks metric with custom properties and metrics' {
+      { $sut.TrackMetric('metric',1,@{customProperty='a'}, @{customMetric=3.0}) } | Should Not Throw
+    }
+  }
+
+  Context 'TrackTrace' {
+    BeforeEach {$sut = New-TelemetryClient -InstrumentationKey "iKey" }
+
+    It 'tracks traces ' {
+      { $sut.TrackTrace('trace') } | Should Not Throw
+    }
+
+    It 'tracks traces with severity level' {
+      { $sut.TrackTrace('trace', 'verbose') } | Should Not Throw
+    }
+    It 'tracks traces with severity level, and custom properties' {
+      { 
+        $sut.TrackTrace('trace', 'Verbose', @{customProperty='PowerShell!'}
+        ) 
+      } | Should Not Throw
+    }
+    It 'tracks traces with severity level, custom properties and custom metrics' {
+      {   
+        $sut.TrackTrace('trace', 
+          'verbose', 
+          @{'customProperty'='PowerShell!'}, 
+          @{customMetrics=3.0}
+        ) 
+      } | Should Not Throw
+    }
+
+    It 'does not throw if it traces with invalid severity because core sdk never throws' {
+      { $sut.TrackTrace('trace', 'invalid') } | Should Not Throw
+    }
+  }
+
+  Context 'TrackException' {
+    BeforeEach {
+      $sut = New-TelemetryClient -InstrumentationKey "iKey" 
+      try{ throw 'exception'} catch { $exception = $_.Exception}
+    }
+
+    It 'tracks exceptions' {
+      { $sut.TrackException($exception) } | Should Not Throw
+    }
+
+    It 'tracks exceptions with custom properties' {
+      {
+        $sut.TrackException($exception, 
+          @{customProperty='PowerShell!'}
+        ) 
+      } | Should Not Throw
+    }
+    It 'tracks exceptions with custom properties and custom metrics' {
+      {
+        $sut.TrackException($exception, 
+          @{'customProperty'='PowerShell!'}, 
+          @{customMetrics=3.0}
+        ) 
+      } | Should Not Throw
+    }
+  }
+}
\ No newline at end of file
diff --git a/PSApplicationInsights/build.ps1 b/PSApplicationInsights/build.ps1
new file mode 100644
index 0000000..db22f96
--- /dev/null
+++ b/PSApplicationInsights/build.ps1
@@ -0,0 +1,13 @@
+# restore NuGet packages
+. $PSScriptRoot\..\NuGet.exe install $PSScriptRoot\packages.config -OutputDirectory $PSScriptRoot\PSApplicationInsights\
+
+# run tests
+Import-Module Pester
+$testResults = Invoke-Pester -Script $PSScriptRoot\Tests\PSApplicationInsights.Tests.ps1 -PassThru
+
+if ($testResults.FailedCount -gt 0)
+{
+  throw "BUILD FAILED: There were $($testResults.FailedCount ) failed tests... stopping"
+}
+
+# deploy?
\ No newline at end of file
diff --git a/PSApplicationInsights/examples/PSApplicationInsightsExamples.ps1 b/PSApplicationInsights/examples/PSApplicationInsightsExamples.ps1
new file mode 100644
index 0000000..0b7e16f
--- /dev/null
+++ b/PSApplicationInsights/examples/PSApplicationInsightsExamples.ps1
@@ -0,0 +1,82 @@
+<#  
+# old way
+Add-Type -Path "microsoft.applicationinsights.2.0.0-rc1\lib\net45\Microsoft.ApplicationInsights.dll" 
+$tc = New-Object -TypeName Microsoft.ApplicationInsights.TelemetryClient
+$tc.InstrumentationKey = "iKey"
+#>  
+
+# PSApplicationInsights
+$tc = New-TelemetryClient -InstrumentationKey "iKey"
+
+# Events
+
+$tc.TrackEvent('event')
+$tc.TrackEvent('event', @{customProperty='PowerShell!'})
+$tc.TrackEvent('event', @{customProperty='PowerShell!'}, @{customMetrics=3.0})
+  
+# Metrics
+
+$tc.TrackMetric('metric', 1)
+$tc.TrackMetric('metric', 1, @{customProperty='PowerShell!'})
+$tc.TrackMetric('metric', 1, @{customProperty='PowerShell!'}, @{customMetrics=3.0})
+  
+# Traces
+  
+$tc.TrackTrace('trace')
+$tc.TrackTrace('trace', 'Verbose')
+$tc.TrackTrace('trace', 'Verbose', @{customProperty='PowerShell!'})
+$tc.TrackTrace('trace', 'Verbose', @{customProperty='PowerShell!'}, @{customMetrics=3.0})
+  
+# Exceptions  
+
+try{ 
+  throw 'exception'
+} 
+catch { 
+  $exception = $_.Exception
+
+  $tc.TrackException($exception)
+  $tc.TrackException($exception, @{customProperty='PowerShell!'})
+  $tc.TrackException($exception, @{customProperty='PowerShell!'}, @{customMetrics=3.0})   
+}
+
+# Availability 
+
+function Get-Availability
+{
+  $true # or custom logic / Invoke-RestMethod
+}
+
+$duration = Measure-Command {
+  [bool] $isSuccess = Get-Availability
+}
+
+if ($isSuccess) {
+  $tc.TrackAvailability('test',(Get-Date), $duration, 'run from powershell!', $isSuccess)
+}
+else {  
+  $tc.TrackAvailability('test',(Get-Date), $duration, 'run from powershell!', $false, 'more detailed error message')
+}
+
+# Dependency
+
+function Get-Dependency
+{
+  $true # or custom logic / Invoke-RestMethod
+}
+
+$duration = Measure-Command {
+  [bool] $result = Get-Dependency
+}
+
+$tc.TrackDependency('dependency name', 'command name', (Get-Date), $duration, $result) 
+$tc.TrackDependency('dependency type name', 'target', 'dependency name', 'data', (Get-Date), $duration, '200', $result)
+
+# Page View
+$tc.TrackPageView('page name')
+
+# Request
+$tc.TrackRequest('name', (Get-Date), $duration, '200', $true)
+
+# Flush
+$tc.Flush()
\ No newline at end of file
diff --git a/PSApplicationInsights/packages.config b/PSApplicationInsights/packages.config
new file mode 100644
index 0000000..9b2d333
--- /dev/null
+++ b/PSApplicationInsights/packages.config
@@ -0,0 +1,4 @@
+<?xml version="1.0" encoding="utf-8"?>
+<packages>
+  <package id="Microsoft.ApplicationInsights" version="2.2.0-beta4" targetFramework="net45" />
+</packages>
\ No newline at end of file