Merge pull request #6458 from v-geberr/0613-cognitiveservices-examples

documentation examples for using cognitive services powershell cmdlets

Author: Maddie Clayton

src/ResourceManager/CognitiveServices/ChangeLog.md

@@ -18,6 +18,7 @@
         - Additional information about change #1
 -->
 ## Current Release
+* Update examples for CognitiveServices cmdlets
 
 ## Version 0.9.5
 * Set minimum dependency of module to PowerShell 5.0

src/ResourceManager/CognitiveServices/Commands.Management.CognitiveServices/help/Get-AzureRmCognitiveServicesAccount.md

@@ -32,6 +32,25 @@ If you do not specify the *ResoureGroupName* parameter, this cmdlet gets all Cog
 
 ## EXAMPLES
 
+### Example 1
+```powershell
+PS C:\> New-AzureRmCognitiveServicesAccount -ResourceGroupName cognitive-services-resource-group -name myluis -Type LUIS -SkuName S0 -Locati
+on 'WestUS'
+
+ResourceGroupName : cognitive-services-resource-group
+AccountName       : myluis
+Id                : /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/cognitive-services-resource-group/providers/Microsoft.Cog
+                    nitiveServices/accounts/myluis
+Endpoint          : https://westus.api.cognitive.microsoft.com/luis/v2.0
+Location          : WESTUS
+Sku               : Microsoft.Azure.Management.CognitiveServices.Models.Sku
+AccountType       : LUIS
+ResourceType      : Microsoft.CognitiveServices/accounts
+Etag              : "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
+ProvisioningState : Succeeded
+Tags              :
+```
+
 ## PARAMETERS
 
 ### -DefaultProfile

src/ResourceManager/CognitiveServices/Commands.Management.CognitiveServices/help/Get-AzureRmCognitiveServicesAccountKey.md

@@ -28,6 +28,15 @@ Use New-AzureRmCognitiveServicesAccountKey to regenerate a key.
 
 ## EXAMPLES
 
+### Example 1
+```powershell
+PS C:\> Get-AzureRmCognitiveServicesAccountKey -ResourceGroupName cognitive-services-resource-group -name myluis
+
+Key1                             Key2
+----                             ----
+xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
+```
+
 ## PARAMETERS
 
 ### -DefaultProfile

src/ResourceManager/CognitiveServices/Commands.Management.CognitiveServices/help/Get-AzureRmCognitiveServicesAccountSkus.md

@@ -28,6 +28,17 @@ Paid tiers include S0, S1, S2, and so on.
 
 ## EXAMPLES
 
+### Example 1
+```powershell
+PS C:\> (Get-AzureRmCognitiveServicesAccountSkus -ResourceGroupName cognitive-services-resource-group -Name myluis).Value | Select-Object -E
+xpandProperty Sku;
+
+Name     Tier
+----     ----
+F0       Free
+S0   Standard
+```
+
 ## PARAMETERS
 
 ### -DefaultProfile

src/ResourceManager/CognitiveServices/Commands.Management.CognitiveServices/help/New-AzureRmCognitiveServicesAccount.md

@@ -27,7 +27,23 @@ specified type and SKU.
 
 ### 1:
 ```
-New-AzureRmCognitiveServicesAccount -ResourceGroupName 'resourcegroup1' -name 'MyAccountName' -Type TextTranslation -SkuName F0 -Location 'usgovvirginia'
+PS C:\> New-AzureRmCognitiveServicesAccount -ResourceGroupName cognitive-services-resource-group -name myluis -Type LUIS -SkuName S0 -Locatio
+n 'WestUS'
+
+
+ResourceGroupName : cognitive-services-resource-group
+AccountName       : myluis
+Id                : /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/cognitive-services-resource-group/providers/Microsoft.Cog
+                    nitiveServices/accounts/myluis
+Endpoint          : https://westus.api.cognitive.microsoft.com/luis/v2.0
+Location          : WestUS
+Sku               : Microsoft.Azure.Management.CognitiveServices.Models.Sku
+AccountType       : LUIS
+ResourceType      : Microsoft.CognitiveServices/accounts
+Etag              : "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
+ProvisioningState : Succeeded
+Tags              :
+
 ```
 
 ## PARAMETERS

src/ResourceManager/CognitiveServices/Commands.Management.CognitiveServices/help/New-AzureRmCognitiveServicesAccountKey.md

@@ -23,6 +23,15 @@ The **New-AzureRmCognitiveServicesAccountKey** cmdlet regenerates an API key for
 
 ## EXAMPLES
 
+### Example 1
+```powershell
+PS C:\> New-AzureRmCognitiveServicesAccountKey -ResourceGroupName cognitive-services-resource-group -name myluis -keyname Key1
+
+Key1                             Key2
+----                             ----
+xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
+```
+
 ## PARAMETERS
 
 ### -DefaultProfile

src/ResourceManager/CognitiveServices/Commands.Management.CognitiveServices/help/Remove-AzureRmCognitiveServicesAccount.md

@@ -23,6 +23,14 @@ The **Remove-AzureRmCognitiveServicesAccount** cmdlet deletes the specified Cogn
 
 ## EXAMPLES
 
+### Example 1
+This command doesn't return anything.
+
+```powershell
+PS C:\> Remove-AzureRmCognitiveServicesAccount -ResourceGroupName cognitive-services-resource-group -name myluis
+PS C:\> 
+```
+
 ## PARAMETERS
 
 ### -DefaultProfile

src/ResourceManager/CognitiveServices/Commands.Management.CognitiveServices/help/Set-AzureRmCognitiveServicesAccount.md

@@ -24,6 +24,25 @@ The **Set-AzureRmCognitiveServicesAccount** cmdlet modifies the SKU or tags of t
 
 ## EXAMPLES
 
+### Example 1
+```powershell
+PS C:\> Set-AzureRmCognitiveServicesAccount -ResourceGroupName cognitive-services-resource-group -name myluis -SkuName S0
+
+
+ResourceGroupName : cognitive-services-resource-group
+AccountName       : myluis
+Id                : /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/cognitive-services-resource-group/providers/Microsoft.Cog
+                    nitiveServices/accounts/myluis
+Endpoint          : https://westus.api.cognitive.microsoft.com/luis/v2.0
+Location          : WESTUS
+Sku               : Microsoft.Azure.Management.CognitiveServices.Models.Sku
+AccountType       : LUIS
+ResourceType      : Microsoft.CognitiveServices/accounts
+Etag              : "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
+ProvisioningState : Succeeded
+Tags              :
+```
+
 ## PARAMETERS
 
 ### -DefaultProfile