Merge pull request #1 from leshkinski/master

Initial module code completed

Author: Horacio Fernandez

DSCResources/RS_rsSysLocale/RS_rsSysLocale.psm1

@@ -0,0 +1,82 @@
+function Get-TargetResource
+{
+	[CmdletBinding()]
+	[OutputType([System.Collections.Hashtable])]
+	param
+	(
+		[parameter(Mandatory = $true)]
+		[System.String]
+		$TimeZone
+	)
+
+    [string]$CurrentTZ = Invoke-Command {tzutil /g}
+    Write-Verbose "Current TZ Setting is $CurrentTZ"
+
+	$returnValue = @{
+		TimeZone = $CurrentTZ
+	}
+
+	$returnValue
+}
+
+
+function Set-TargetResource
+{
+	[CmdletBinding()]
+	param
+	(
+		[parameter(Mandatory = $true)]
+		[System.String]
+		$TimeZone
+	)
+
+    try
+    {
+        [string]$CurrentTZ = Invoke-Command {tzutil /g}
+        Write-Verbose "Setting TZ Setting to $TimeZone"
+        Invoke-Command {tzutil /s $TimeZone}
+    }
+    catch
+    {
+        
+    }
+}
+
+
+function Test-TargetResource
+{
+	[CmdletBinding()]
+	[OutputType([System.Boolean])]
+	param
+	(
+		[parameter(Mandatory = $true)]
+		[System.String]
+		$TimeZone
+	)
+
+    try
+    {
+        [string]$CurrentTZ = Invoke-Command {tzutil /g}
+        Write-Verbose "Current TZ Setting is $CurrentTZ"
+
+        if ($CurrentTZ -like $TimeZone)
+        {
+            Write-Verbose "TZ setting is consistent"
+            $result = $true
+        }
+        else
+        {
+            Write-Verbose "TZ setting is inconsistent"
+            $result = $false
+        }
+
+    }
+    catch
+    {
+        
+    }
+
+	$result
+}
+
+Export-ModuleMember -Function *-TargetResource

DSCResources/RS_rsSysLocale/RS_rsSysLocale.schema.mof

@@ -0,0 +1,7 @@
+
+[ClassVersion("1.0"), FriendlyName("rsTime")]
+class RS_rsTime : OMI_BaseResource
+{
+	[Key, Description("Provide desired system TZ (execute tzutil /l to see full list of possible options)")] String TimeZone;
+};
+

DSCResources/RS_rsTime/RS_rsTime.psm1

@@ -1,4 +1,105 @@
-rsInternationalSettings
+rsInternationalSettings DSC Module
 =======================
 
-DSC Resource to manage international system settings
+**rsInternationalSettings** is a PowerShell DSC resource module, which can be used to manage international system settings such as setting system locale, time zone user keyboard layout and culture (formatting) settings.
+
+##Changelog
+
+######v0.0.1
+Added support for setting time zone, culture, system local and all local (including default) user profile settings.
+
+####To-do:
+Add support for provision of an optional time server parameter
+
+##Syntax##
+
+See usage examples below...
+
+###Usage Examples
+
+**Set Server to US locale and user input**
+
+This will force all system and user settings to US codepage, including input setting:
+
+    rsSysLocale SysLoc
+    {
+    	SysLocale = "en-US"
+    }
+    
+    rsTime time
+    {
+    	TimeZone = "Central Standard Time"
+    }
+    
+    rsUserLocale UserLocale
+    {
+    	Name = "UserLocale"
+		Culture = "en-US"
+    	LocationID = "244"
+    	LCIDHex = "0409"
+    	InputLocaleID = "00000409"
+    }
+
+
+**Set Server to UK locale and user input**
+
+This will force all system and user settings to UK codepage, including input setting:
+
+    rsSysLocale SysLoc
+    {
+    	SysLocale = "en-GB"
+    }
+    
+    rsTime time
+    {
+    	TimeZone = "GMT Standard Time"
+    }
+    
+    rsUserLocale UserLocale
+    {
+    	Name = "UserLocale"
+		Culture = "en-GB"
+    	LocationID = "242"
+    	LCIDHex = "0809"
+    	InputLocaleID = "00000809"
+    }
+
+
+
+###Acceptable parameter values
+
+#####$Culture
+Default system codepage for non-Unicode applications. 
+Use the following PowerShell command to list all available options:
+
+    [cultureinfo]::GetCultures([System.Globalization.CultureTypes]::AllCultures)
+
+#####$TimeZone
+System time zone name description. Ex "GMT Standard Time"
+Use the `tzutil /l` command to list all possible options.
+
+#####$LocationID
+Geographical System location ID (GEOID). Refer to [Table of Geographical Locations](http://msdn.microsoft.com/en-us/library/windows/desktop/dd374073(v=vs.85).aspx) for full list of possible options.
+
+#####$LCIDHex
+Keyboard Language ID as defined by Microsoft. Used in combination with InputLocaleID, see [Keyboard Language & Locale IDs Assigned by Microsoft](http://msdn.microsoft.com/en-gb/goglobal/bb895996.aspx)
+
+#####$InputLocaleID
+Locale ID as defined by Microsoft. Used in combination with LCIDHex, see [Keyboard Language & Locale IDs Assigned by Microsoft](http://msdn.microsoft.com/en-gb/goglobal/bb895996.aspx)
+
+###Keyboard options tip:
+To easily identify correct settings for user keyboard options (*LCIDHex* & *InputLocaleID*), set the desired keyboard settings on a Windows 8/2012, or later, machine and run the following PS command `Get-WinUserLanguageList`. Property named "InputMethodTips" will provide the correct Language Code ID as `{<LCIDHex>:<InputLocaleID>}`.
+
+#####Example:
+
+    PS C:\Users\Administrator> Get-WinUserLanguageList
+    
+    LanguageTag : en-US
+    Autonym : English (United States)
+    EnglishName : English
+    LocalizedName   : English (United States)
+    ScriptName  : Latin script
+    InputMethodTips : {0409:00000409}
+    Spellchecking   : True
+    Handwriting : False
+