Merge pull request #1 from PowerShell/staging

UPD 2017-06-22

Author: yeremee

.gitignore

@@ -14,4 +14,5 @@ out_maml/
 packages.config
 **/.ignore/**
 *.orig
+.vscode/
 

STYLE.md

@@ -35,12 +35,24 @@ Header 2
 ## Syntax
 
 * When talking about a cmdlet in paragraph, use \` to highlight cmdlet names
-  * When writing an article (as opposed to reference content), the first instance of a cmdlet name should be a link to the cmdlet documentation
+  * Correct Example:
+  This `Write-Host` Cmdlet can ...
+  * Incorrect Example:
+  This **Write-Host** Cmdlet can ... and pipeline to out-file Cmdlet to ...
+* When writing an article (as opposed to reference content), the first instance of a cmdlet name should be a link to the cmdlet documentation
 * All PowerShell syntax blocks should use ```powershell
-* Do not start PowerShell commands with "C:\ PS>"
+* Do not start PowerShell commands with "`PS C:\>`"
+  * Correct Example:
+  ```powershell
+  Get-Process
+  ```
+  * Incorrect Example:
+  ```powershell
+  PS C:\> Get-Process
+  ```
 * Output emitted by PowerShell commands should be commented to prevent it from recieving syntax highlighting
 * Property names and parameter names should be in **bold**
-
+* PowerShell cmdlets are "[Pascal Cased](https://en.wikipedia.org/wiki/PascalCase)". Verbs are seperated from nouns by a hyphen.
 
 ## Lists
 

dsc/DSCAutomationHostEnabled.md

@@ -1,13 +1,9 @@
-
 ---
-title:   DSCAutomationHostEnabled registry key
-ms.date:  2016-05-16
-keywords:  powershell,DSC
-description:  
-ms.topic:  article
+ms.date:  2017-06-12
 author:  eslesar
-manager:  dongill
-ms.prod:  powershell
+ms.topic:  conceptual
+keywords:  dsc,powershell,configuration,setup
+title:  DSCAutomationHostEnabled registry key
 ---
 
 >Applies to: Windows PowerShell 5.0

dsc/DscForEngineers.md

@@ -1,12 +1,9 @@
 ---
-title:   Desired State Configuration Overview for Decision Makers 
-ms.date:  2017-03-13
-keywords:  powershell,DSC
-description:  
-ms.topic:  article
+ms.date:  2017-06-12
 author:  eslesar
-manager:  carmonm
-ms.prod:  powershell
+ms.topic:  conceptual
+keywords:  dsc,powershell,configuration,setup
+title:  Desired State Configuration Overview for Decision Makers
 ---
 
 # Desired State Configuration Overview for Engineers #
@@ -141,3 +138,4 @@ To deploy to the different environments, you can invoke `Start-DscConfiguration`
 [Configuration Data](configData.md)
 
 [Resources](resources.md)
+

dsc/PackageManagementDscResource.md

@@ -1,12 +1,9 @@
 ---
-title:   DSC PackageManagement Resource
-ms.date:  
-keywords:  powershell,DSC
-description:  
-ms.topic:  article
-author:  brywang-msft
-manager:  kriscv
-ms.prod:  powershell
+ms.date:  2017-06-12
+author:  eslesar
+ms.topic:  conceptual
+keywords:  dsc,powershell,configuration,setup
+title:  DSC PackageManagement Resource
 ---
 
 # DSC PackageManagement Resource
@@ -94,4 +91,5 @@ Configuration PackageTest
 		DependsOn            = "[PackageManagementSource]PSGallery" 
     }
 }
-```
+```
+

dsc/PackageManagementSourceDscResource.md

@@ -1,12 +1,9 @@
 ---
-title:   DSC PackageManagementSource Resource
-ms.date:  
-keywords:  powershell,DSC
-description:  
-ms.topic:  article
-author:  brywang-msft
-manager:  kriscv
-ms.prod:  powershell
+ms.date:  2017-06-12
+author:  eslesar
+ms.topic:  conceptual
+keywords:  dsc,powershell,configuration,setup
+title:  DSC PackageManagementSource Resource
 ---
 
 # DSC PackageManagementSource Resource
@@ -56,3 +53,4 @@ Configuration PackageManagementSourceTest
 	}
 }
 ```
+

dsc/TOC.md

@@ -11,7 +11,7 @@
 ## [Specifying cross-node dependencies](crossNodeDependencies.md)
 ## [Configuration data](configData.md)
 ### [Credential options in configuration data](configDataCredentials.md)
-## [Nestng configurations](compositeConfigs.md)
+## [Nesting configurations](compositeConfigs.md)
 ## [Securing the configuration MOF file](secureMOF.md)
 ## [Partial Configurations](partialConfigs.md)
 ## [Writing help for DSC configurations](configHelp.md)
@@ -33,10 +33,14 @@
 ### [Service Resource](serviceResource.md)
 ### [ServiceSet Resource](serviceSetResource.md)
 ### [User Resource](userResource.md)
+### [WaitForAllResource](waitForAllResource.md)
+### [WaitForAnyResource](waitForAnyResource.md)
+### [WaitForSomeResource](waitForSomeResource.md)
 ### [WindowsFeature Resource](windowsfeatureResource.md)
 ### [WindowsFeatureSet Resource](windowsFeatureSetResource.md)
 ### [WindowsOptionalFeature Resource](windowsOptionalFeatureResource.md)
 ### [WindowsOptionalFeatureSet Resource](windowsOptionalFeatureSetResource.md)
+### [WindowsPackageCab Resource](windowsPackageCabResource.md)
 ### [WindowsProcess Resource](windowsProcessResource.md)
 ## [Authoring custom resources](authoringResource.md) 
 ### [MOF-based custom resources](authoringResourceMOF.md)
@@ -60,6 +64,10 @@
 ## [Using a DSC report server](reportServer.md)
 ## [Pull server best practices](secureServer.md)
 
+# [DSC examples](dscExamples.md)
+## [Building a CI/CD pipeline with DSC, Pester, and Visual Studio Team Services](dscCiCd.md)
+## [Separating configuration and environment data](separatingEnvData.md)
+
 # [Troubleshooting DSC](troubleshooting.md)
 
 # [Using DSC on Nano Server](nanoDsc.md)

dsc/archiveResource.md

@@ -1,12 +1,9 @@
 ---
-title:   DSC Archive Resource
-ms.date:  2016-05-16
-keywords:  powershell,DSC
-description:  
-ms.topic:  article
+ms.date:  2017-06-12
 author:  eslesar
-manager:  dongill
-ms.prod:  powershell
+ms.topic:  conceptual
+keywords:  dsc,powershell,configuration,setup
+title:  DSC Archive Resource
 ---
 
 # DSC Archive Resource

dsc/authoringResource.md

@@ -1,12 +1,9 @@
 ---
-title:   Build Custom Windows PowerShell Desired State Configuration Resources
-ms.date:  2016-05-16
-keywords:  powershell,DSC
-description:  
-ms.topic:  article
+ms.date:  2017-06-12
 author:  eslesar
-manager:  dongill
-ms.prod:  powershell
+ms.topic:  conceptual
+keywords:  dsc,powershell,configuration,setup
+title:  Build Custom Windows PowerShell Desired State Configuration Resources
 ---
 
 # Build Custom Windows PowerShell Desired State Configuration Resources

dsc/authoringResourceClass.md

@@ -1,12 +1,9 @@
 ---
-title:   Writing a custom DSC resource with PowerShell classes
-ms.date:  2016-05-16
-keywords:  powershell,DSC
-description:  
-ms.topic:  article
+ms.date:  2017-06-12
 author:  eslesar
-manager:  dongill
-ms.prod:  powershell
+ms.topic:  conceptual
+keywords:  dsc,powershell,configuration,setup
+title:  Writing a custom DSC resource with PowerShell classes
 ---
 
 # Writing a custom DSC resource with PowerShell classes
@@ -472,6 +469,44 @@ Test
 Start-DscConfiguration -Wait -Force Test
 ```
 
+## Supporting PsDscRunAsCredential
+
+>**Note:** **PsDscRunAsCredential** is supported in PowerShell 5.0 and later.
+
+The **PsDscRunAsCredential** property can be used in [DSC configurations](configurations.md) resource block to specify that the 
+resource should be run under a specified set of credentials.
+For more information, see [Running DSC with user credentials](runAsUser.md).
+
+### Require or disallow PsDscRunAsCredential for your resource
+
+The **DscResource()** attribute takes an optional parameter **RunAsCredential**.
+This parameter takes one of three values:
+
+- `Optional` **PsDscRunAsCredential** is optional for configurations that call this resource. This is the default value.
+- `Mandatory` **PsDscRunAsCredential** must be used for any configuration that calls this resource.
+- `NotSupported` Configurations that call this resource cannot use **PsDscRunAsCredential**.
+- `Default` Same as `Optional`.
+
+For example, use the following attribute to specify that your custom resource does not support using **PsDscRunAsCredential**:
+
+```powershell
+[DscResource(RunAsCredential=NotSupported)]
+class FileResource {
+}
+```
+
+### Access the user context
+
+To access the user context from within a custom resource, you can use the automatic variable `$global:PsDscContext`.
+
+For example the following code would write the user context under which the resource is running to the verbose output stream:
+
+```powershell
+if (PsDscContext.RunAsUser) {
+    Write-Verbose "User: $global:PsDscContext.RunAsUser";
+}
+```
+
 ## See Also
 ### Concepts
 [Build Custom Windows PowerShell Desired State Configuration Resources](authoringResource.md)