Conceptual documentation improvements from feedback.

Author: twitchax

azureps-cmdlets-docs/ResourceManager/docs-conceptual/get-started-azureps.md

@@ -27,7 +27,7 @@ The first step is to make sure you have the latest version of the Azure PowerShe
    command line.
 
 You should see the version number of the AzureRM module installed and loaded in your PowerShell
-session.
+session.  The latest version is can be found in the [release notes](release-notes-azureps.md).
 
 ## Log in to Azure
 
@@ -91,9 +91,9 @@ $vnet = New-AzureRmVirtualNetwork -ResourceGroupName $resourceGroup -Location $l
   -Name MYvNET1 -AddressPrefix 192.168.0.0/16 -Subnet $subnetConfig
 
 # Create a public IP address and specify a DNS name
-$pip = New-AzureRmPublicIpAddress -ResourceGroupName $resourceGroup -Location $location `
+$publicIp = New-AzureRmPublicIpAddress -ResourceGroupName $resourceGroup -Location $location `
   -Name "mypublicdns$(Get-Random)" -AllocationMethod Static -IdleTimeoutInMinutes 4
-$pip | Select-Object Name,IpAddress
+$publicIp | Select-Object Name,IpAddress
 
 # Create an inbound network security group rule for port 3389
 $nsgRuleRDP = New-AzureRmNetworkSecurityRuleConfig -Name myNetworkSecurityGroupRuleRDP  -Protocol Tcp `
@@ -106,7 +106,7 @@ $nsg = New-AzureRmNetworkSecurityGroup -ResourceGroupName $resourceGroup -Locati
 
 # Create a virtual network card and associate with public IP address and NSG
 $nic = New-AzureRmNetworkInterface -Name myNic1 -ResourceGroupName $resourceGroup -Location $location `
-  -SubnetId $vnet.Subnets[0].Id -PublicIpAddressId $pip.Id -NetworkSecurityGroupId $nsg.Id
+  -SubnetId $vnet.Subnets[0].Id -PublicIpAddressId $publicIp.Id -NetworkSecurityGroupId $nsg.Id
 ```
 
 ### Create the virtual machine
@@ -144,7 +144,7 @@ Now log on to your newly created Windows Server VM using Remote Desktop and the
 of the VM. The following command displays the public IP address created in the previous script.
 
 ```powershell
-$pip | Select-Object Name,IpAddress
+$publicIp | Select-Object Name,IpAddress
 ```
 
 ```
@@ -195,9 +195,9 @@ $vnet = New-AzureRmVirtualNetwork -ResourceGroupName $resourceGroup -Location $l
   -Name MYvNET2 -AddressPrefix 192.168.0.0/16 -Subnet $subnetConfig
 
 # Create a public IP address and specify a DNS name
-$pip = New-AzureRmPublicIpAddress -ResourceGroupName $resourceGroup -Location $location `
+$publicIp = New-AzureRmPublicIpAddress -ResourceGroupName $resourceGroup -Location $location `
   -Name "mypublicdns$(Get-Random)" -AllocationMethod Static -IdleTimeoutInMinutes 4
-$pip | Select-Object Name,IpAddress
+$publicIp | Select-Object Name,IpAddress
 
 # Create an inbound network security group rule for port 22
 $nsgRuleSSH = New-AzureRmNetworkSecurityRuleConfig -Name myNetworkSecurityGroupRuleSSH  -Protocol Tcp `
@@ -210,7 +210,7 @@ $nsg = New-AzureRmNetworkSecurityGroup -ResourceGroupName $resourceGroup -Locati
 
 # Create a virtual network card and associate with public IP address and NSG
 $nic = New-AzureRmNetworkInterface -Name myNic2 -ResourceGroupName $resourceGroup -Location $location `
-  -SubnetId $vnet.Subnets[0].Id -PublicIpAddressId $pip.Id -NetworkSecurityGroupId $nsg.Id
+  -SubnetId $vnet.Subnets[0].Id -PublicIpAddressId $publicIp.Id -NetworkSecurityGroupId $nsg.Id
 ```
 
 ### Create the virtual machine

azureps-cmdlets-docs/ResourceManager/docs-conceptual/manage-subscriptions-azureps.md

@@ -50,7 +50,7 @@ PowerShell to execute commands against a particular subscription.
 2. Set the default.
 
     ```powershell
-    Get-AzureRmSubscription -SubscriptionName "My Demos" | Select-AzureRmSubscription
+    Select-AzureRmSubscription -SubscriptionName "My Demos"
     ```
 
 3. Verify the change by running the `Get-AzureRmContext` cmdlet.

azureps-cmdlets-docs/ResourceManager/docs-conceptual/overview.md

@@ -34,13 +34,6 @@ The following samples can help you learn how to perform common scenarios with Az
 install the Service Management version of Azure PowerShell. For more information, see
 [Install the Azure PowerShell Service Management module](install-azure-ps?view=azuresmps-3.7.0).
 
-### Need a better understanding of Azure?
-
-For more information about Azure, consult the [Azure documentation](/azure/).
-
-To learn more about automating with Azure PowerShell, watch this video:
-[Take Control of the Cloud with the Microsoft Azure PowerShell Cmdlets](https://channel9.msdn.com/Events/TechEd/NorthAmerica/2013/WAD-B305#fbid=).
-
 ### Need help with PowerShell?
 
 If you are unfamiliar with PowerShell you may find an introduction to PowerShell helpful. To get started with PowerShell, see

azureps-cmdlets-docs/ResourceManager/docs-conceptual/queries-azureps.md

@@ -14,7 +14,7 @@ ms.author: sewhee
 
 # Querying for Azure resources
 
-There is no special query language required to query resources using Azure PowerShell. In
+Querying in PowerShell can be completed by using built-in cmdlets. In
 PowerShell, cmdlet names take the form of **_Verb-Noun_**. The cmdlets using the verb **_Get_** are
 the query cmdlets. The cmdlet nouns are the types of Azure resources that are acted upon by the
 cmdlet verbs.
@@ -61,7 +61,7 @@ path to that nested property. The following example shows how to select the VM N
 from the `Get-AzureRmVM` cmdlet.
 
 ```powershell
-Get-AzureRmVM | Select-Object name,@{n='OSType';e={$_.StorageProfile.OSDisk.OSType}}
+Get-AzureRmVM | Select-Object name,@{Name='OSType'; Expression={$_.StorageProfile.OSDisk.OSType}}
 ```
 
 ```