microsoft · Derek (derekfreed) · May 1, 2018 · Apr 27, 2018
diff --git a/UnitySetup/DSCResources/xUnityLicense/xUnityLicense.psm1 b/UnitySetup/DSCResources/xUnityLicense/xUnityLicense.psm1
@@ -0,0 +1,101 @@
+function Get-TargetResource {
+    [CmdletBinding()]
+    [OutputType([System.Collections.Hashtable])]
+    param
+    (
+        [System.Management.Automation.PSCredential]
+        $Credential,
+
+        [System.Management.Automation.PSCredential]
+        $Serial,
+
+        [System.String]
+        $UnityVersion,
+
+        [System.String]
+        $Name
+    )
+
+    @{ 'Licenses' = (Get-UnityLicense) }
+}
+
+
+function Set-TargetResource {
+    [CmdletBinding()]
+    param
+    (
+        [parameter(Mandatory = $true)]
+        [System.Management.Automation.PSCredential]
+        $Credential,
+
+        [ValidateSet("Present", "Absent")]
+        [System.String]
+        $Ensure = 'Present',
+
+        [parameter(Mandatory = $true)]
+        [System.Management.Automation.PSCredential]
+        $Serial,
+
+        [System.String]
+        $UnityVersion,
+
+        [parameter(Mandatory = $true)]
+        [System.String]
+        $Name
+    )
+
+    if ( Test-TargetResource @PSBoundParameters ) { return }
+
+    $unityArgs = @{ 
+        'Credential' = $Credential 
+        'Wait'       = $true
+    }
+
+    if ( $UnityVersion ) { $unityArgs['Version'] = $UnityVersion }
+    if ( $Ensure -eq 'Present' ) { $unityArgs['Serial'] = $Serial.Password }
+    else { $unityArgs['ReturnLicense'] = $true }
+
+    Start-UnityEditor @unityArgs -Verbose
+}
+
+
+function Test-TargetResource {
+    [CmdletBinding()]
+    [OutputType([System.Boolean])]
+    param
+    (
+        [System.Management.Automation.PSCredential]
+        $Credential,
+
+        [ValidateSet("Present", "Absent")]
+        [System.String]
+        $Ensure = 'Present',
+
+        [parameter(Mandatory = $true)]
+        [System.Management.Automation.PSCredential]
+        $Serial,
+
+        [System.String]
+        $UnityVersion,
+
+        [parameter(Mandatory = $true)]
+        [System.String]
+        $Name
+    )
+
+    foreach ( $license in (Get-UnityLicense -Serial $Serial.Password) ) {
+        Write-Verbose "Found license: $license"
+
+        $currentSerial = [System.Net.NetworkCredential]::new($null, $license.Serial).Password
+        $passedSerial = $Serial.GetNetworkCredential().Password 
+        if ( $currentSerial -ne $passedSerial ) { continue }
+
+        return $Ensure -eq 'Present'
+    }
+
+    return $Ensure -eq 'Absent'
+}
+
+
+Export-ModuleMember -Function *-TargetResource
+
diff --git a/UnitySetup/DSCResources/xUnityLicense/xUnityLicense.schema.mof b/UnitySetup/DSCResources/xUnityLicense/xUnityLicense.schema.mof
@@ -0,0 +1,11 @@
+
+[ClassVersion("1.0.0.0"), FriendlyName("xUnityLicense")]
+class xUnityLicense : OMI_BaseResource
+{
+    [Key] string Name;
+    [Required, EmbeddedInstance("MSFT_Credential")] String Credential;
+    [Required, EmbeddedInstance("MSFT_Credential")] String Serial;
+    [Write, ValueMap{"Present","Absent"}, Values{"Present","Absent"}] string Ensure;
+    [Write] string UnityVersion;
+};
+
diff --git a/UnitySetup/Examples/Sample_xUnity.ps1 b/UnitySetup/Examples/Sample_xUnity.ps1
@@ -0,0 +1,43 @@
+<#
+    Create a custom configuration by passing in necessary values
+#>
+Configuration Sample_xUnitySetupInstance {
+    param 
+    (       
+        [System.String]
+        $Versions = '2017.4.2f2'
+
+        [ValidateSet('Present', 'Absent')]
+        [System.String]
+        $Ensure = 'Present',
+
+        [System.String[]]
+        $Components = @('Windows', 'Mac', 'Linux', 'Metro', 'iOS', 'Android'),
+
+        [PSCredential]
+        $UnityCredential,
+
+        [PSCredential]
+        $UnitySerial
+    )
+
+    Import-DscResource -ModuleName UnitySetup
+
+    Node 'localhost' {
+
+        xUnitySetupInstance Unity {
+            Versions   = $Versions
+            Components = $Components
+            Ensure     = $Ensure
+            DependsOn  = if( $Ensure -eq 'Absent' ) { '[xUnityLicense]UnityLicense' }
+        }
+
+        xUnityLicense UnityLicense {
+            Name = 'UL01'
+            Credential = $UnityCredential
+            Serial = $UnitySerial
+            Ensure = $Ensure
+            DependsOn = if( $Ensure -eq 'Present' ) { '[xUnitySetupInstance]Unity' }
+        }
+    }
+}
diff --git a/UnitySetup/Examples/Sample_xUnitySetupInstance.ps1 b/UnitySetup/Examples/Sample_xUnitySetupInstance.ps1
diff --git a/UnitySetup/Examples/Sample_xUnitySetupInstance_Install.ps1 b/UnitySetup/Examples/Sample_xUnitySetupInstance_Install.ps1
diff --git a/UnitySetup/Examples/Sample_xUnitySetupInstance_Uninstall.ps1 b/UnitySetup/Examples/Sample_xUnitySetupInstance_Uninstall.ps1
diff --git a/UnitySetup/Examples/Sample_xUnity_Install.ps1 b/UnitySetup/Examples/Sample_xUnity_Install.ps1
@@ -0,0 +1,30 @@
+<#
+    Install multiple versions of Unity and several components
+#>
+Configuration Sample_xUnitySetupInstance_Install {
+
+    param(
+        [PSCredential]$UnityCredential,
+        [PSCredential]$UnitySerial
+    )
+
+    Import-DscResource -ModuleName UnitySetup
+
+    Node 'localhost' {
+
+        xUnitySetupInstance Unity {
+            Versions   = '2017.4.2f2'
+            Components = 'Windows', 'Mac', 'Linux', 'Metro', 'iOS', 'Android'
+            Ensure     = 'Present'
+        }
+
+        xUnityLicense UnityLicense {
+            Name = 'UL01'
+            Credential = $UnityCredential
+            Serial = $UnitySerial
+            Ensure = 'Present'
+            UnityVersion = '2017.4.2f2'
+            DependsOn = '[xUnitySetupInstance]Unity'   
+        }
+    }
+}
diff --git a/UnitySetup/Examples/Sample_xUnity_Uninstall.ps1 b/UnitySetup/Examples/Sample_xUnity_Uninstall.ps1
@@ -0,0 +1,29 @@
+<#
+    Uninstall multiple versions of Unity
+#>
+Configuration Sample_xUnitySetupInstance_Install {
+
+    param(
+        [PSCredential]$UnityCredential,
+        [PSCredential]$UnitySerial
+    )
+
+    Import-DscResource -ModuleName UnitySetup
+
+    Node 'localhost' {
+
+        xUnitySetupInstance Unity {
+            Versions = '2017.4.2f2'
+            Ensure   = 'Absent'
+            DependsOn = '[xUnityLicense]UnityLicense'   
+        }
+
+        xUnityLicense UnityLicense {
+            Name = 'UL01'
+            Credential = $UnityCredential
+            Serial = $UnitySerial
+            Ensure = 'Absent'
+            UnityVersion = '2017.4.2f2'  
+        }
+    }
+}
diff --git a/UnitySetup/UnitySetup.psd1 b/UnitySetup/UnitySetup.psd1
@@ -82,7 +82,8 @@
         'Select-UnitySetupInstance',
         'Uninstall-UnitySetupInstance',
         'Start-UnityEditor',
-        'ConvertTo-UnitySetupComponent'
+        'ConvertTo-UnitySetupComponent',
+        'Get-UnityLicense'
     )
 
     # Cmdlets to export from this module, for best performance, do not use wildcards and do not delete the entry, use an empty array if there are no cmdlets to export.