Merge pull request MicrosoftDocs#252 from Azure/Graham71046

Bug 71046 - ver 3.7

Author: Graham Priestley

azureps-cmdlets-docs/ResourceManager/AzureRM.Resources/v3.7.0/Get-AzureRmRoleDefinition.md

@@ -31,35 +31,34 @@ Get-AzureRmRoleDefinition [-Scope <String>] [-Custom] [-AtScopeAndBelow]
 ```
 
 ## DESCRIPTION
-Use the Get-AzureRmRoleDefinition command with a particular role name to view its details.
+The **Get-AzureRmRoleDefinition** cmdlet gets all Azure role-based access control (RBAC) roles that are available for assignment.
 To inspect individual operations that a role grants access to, review the Actions and NotActions properties of the role.
 
 ## EXAMPLES
 
-### Example 1:
+### Example 1: Get a reader role definition
 
 
 ```
-PS C:\> Get-AzureRmRoleDefinition -Name Reader
+PS C:\> Get-AzureRmRoleDefinition -Name "Reader01"
 ```
 
-Get the Reader role definition
+This command gets the reader role definition from the reader named Reader01.
 
-### Example 2:
+### Example 2: Get all RBAC role definitions
 
 
 ```
 PS C:\> Get-AzureRmRoleDefinition
 ```
 
-Lists all RBAC role definitions
+This command lists all RBAC role definitions.
 
 ## PARAMETERS
 
 ### -Name
-Role definition name.
-For e.g.
-Reader, Contributor, Virtual Machine Contributor.
+Specifies the name of the role definition.
+For instance, Reader, Contributor, Virtual Machine Contributor.
 
 ```yaml
 Type: String
@@ -74,7 +73,7 @@ Accept wildcard characters: False
 ```
 
 ### -Scope
-Role definition scope.
+Specifies the scope of the role definition.
 
 ```yaml
 Type: String
@@ -89,7 +88,7 @@ Accept wildcard characters: False
 ```
 
 ### -AtScopeAndBelow
-If specified, displays all role definitions.
+Indicates that the cmdlet displays all role definitions.
 
 ```yaml
 Type: SwitchParameter
@@ -143,7 +142,7 @@ Accept wildcard characters: False
 ```
 
 ### -Id
-Role definition Id.
+Specifies the ID of the role definition.
 
 ```yaml
 Type: Guid
@@ -158,7 +157,7 @@ Accept wildcard characters: False
 ```
 
 ### -Custom
-If specified, only displays the custom created roles in the directory.
+Indicates that the cmdlet displays only the custom created roles in the directory.
 
 ```yaml
 Type: SwitchParameter
@@ -181,11 +180,10 @@ Keywords: azure, azurerm, arm, resource, management, manager, resource, group, t
 
 ## RELATED LINKS
 
-[New-AzureRmRoleAssignment]()
+[Get-AzureRmRoleAssignment](./Get-AzureRmRoleAssignment.md)
 
-[Get-AzureRmRoleAssignment]()
+[New-AzureRmRoleAssignment](./New-AzureRmRoleAssignment.md)
 
-[New-AzureRmRoleDefinition]()
-
-[Remove-AzureRmRoleDefinition]()
+[New-AzureRmRoleDefinition](./New-AzureRmRoleDefinition.md)
 
+[Remove-AzureRmRoleDefinition](./Remove-AzureRmRoleDefinition.md)

azureps-cmdlets-docs/ResourceManager/AzureRM.Resources/v3.7.0/Invoke-AzureRmResourceAction.md

@@ -44,11 +44,6 @@ To get a list of supported actions, use the Azure Resource Explorer tool.
 
 ## EXAMPLES
 
-### 1:
-```
-
-```
-
 ## PARAMETERS
 
 ### -Parameters
@@ -343,4 +338,3 @@ This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable
 ## NOTES
 
 ## RELATED LINKS
-

azureps-cmdlets-docs/ResourceManager/AzureRM.Resources/v3.7.0/Move-AzureRmResource.md

@@ -30,7 +30,7 @@ PS C:\> $Resource = Get-AzureRmResource -ResourceType "Microsoft.ClassicCompute/
 PS C:\> Move-AzureRmResource -ResourceId $Resource.ResourceId -DestinationResourceGroupName "ResourceGroup14"
 ```
 
-The first command gets a resource named ContosoStorageAccount by using the Get-AzureRmResource cmdlet, and then stores that resource in the $Resource variable.
+The first command gets a resource named ContosoStorageAccount by using the [Get-AzureRmResource](./Get-AzureRmResource.md) cmdlet, and then stores that resource in the $Resource variable.
 
 The second command moves that resource into the resource group named ResourceGroup14.
 The command identifies the resource to move by using the **ResourceId** property of $Resource.
@@ -53,7 +53,7 @@ Accept wildcard characters: False
 ```
 
 ### -DestinationSubscriptionId
-Specifies the ID of the subscription into which this cmdlet moves resources .
+Specifies the ID of the subscription into which this cmdlet moves resources.
 
 ```yaml
 Type: Guid
@@ -218,5 +218,3 @@ This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable
 [Remove-AzureRmResource](./Remove-AzureRmResource.md)
 
 [Set-AzureRmResource](./Set-AzureRmResource.md)
-
-

azureps-cmdlets-docs/ResourceManager/AzureRM.Resources/v3.7.0/New-AzureRmADAppCredential.md

@@ -39,22 +39,22 @@ New-AzureRmADAppCredential -ApplicationId <String> -Password <String> [-StartDat
 ```
 
 ## DESCRIPTION
-The New-AzureRmADAppCredential cmdlet can be used to add a new credential or to roll credentials for an application.
-The application is identified by supplying either the application object id or application Id.
+The **New-AzureRmADAppCredential** cmdlet can be used to add a new credential or to roll credentials for an application.
+The application is identified by supplying either the application object ID or application ID.
 
 ## EXAMPLES
 
-### Example 1:
+### Example 1: Add a new password credential to an existing application
 
 
 ```
 PS C:\> New-AzureRmADAppCredential -ObjectId 1f89cf81-0146-4f4e-beae-2007d0668416 -Password P@ssw0rd!
 ```
 
-A new password credential is added to an existing application.
-In this example, the supplied password value is added to the application using the application object id.
+This command adds a new password credential to an existing application.
+In this example, the supplied password value is added to the application using the application object ID.
 
-### Example 2:
+### Example 2: Add a new key credential to an existing application
 
 
 ```
@@ -69,20 +69,13 @@ $credValue = [System.Convert]::ToBase64String($binCert)
 PS C:\> New-AzureRmADAppCredential -ApplicationId 4589cd6b-3d79-4bb4-93b8-a0b99f3bfc58 -CertValue $credValue -StartDate $cer.GetEffectiveDateString() -EndDate $cer.GetExpirationDateString()
 ```
 
-A new key credential is added to an existing application.
-In this example, the supplied base64 encoded public X509 certificate ("myapp.cer") is added to the application using the applicationId.
-
-### --------------------------  Example 3  --------------------------
-
-
-```
-PS C:\> New-AzureRmADAppCredential -ApplicationId 4589cd6b-3d79-4bb4-93b8-a0b99f3bfc58 -CertValue $credValue
-```
+This example adds a new key credential to an existing application.
+In this example, the supplied base64 encoded public X509 certificate ("myapp.cer") is added to the application using the application ID.
 
 ## PARAMETERS
 
 ### -ObjectId
-The object id of the application to add the credentials to.
+Specifies the object ID of the application that this cmdlet adds the credentials to.
 
 ```yaml
 Type: String
@@ -97,7 +90,7 @@ Accept wildcard characters: False
 ```
 
 ### -Password
-The password to be associated with the application.
+Specifies the password to be associated with the application.
 
 ```yaml
 Type: String
@@ -112,7 +105,7 @@ Accept wildcard characters: False
 ```
 
 ### -StartDate
-The effective start date of the credential usage.
+Specifies the effective start date of the credential usage.
 The default start date value is today.
 For an "asymmetric" type credential, this must be set to on or after the date that the X509 certificate is valid from.
 
@@ -129,7 +122,7 @@ Accept wildcard characters: False
 ```
 
 ### -EndDate
-The effective end date of the credential usage.
+Specifies the effective end date of the credential usage.
 The default end date value is one year from today. 
 For an "asymmetric" type credential, this must be set to on or before the date that the X509 certificate is valid.
 
@@ -185,7 +178,8 @@ Accept wildcard characters: False
 ```
 
 ### -WhatIf
-
+Shows what would happen if the cmdlet runs.
+The cmdlet is not run.
 
 ```yaml
 Type: SwitchParameter
@@ -215,7 +209,7 @@ Accept wildcard characters: False
 ```
 
 ### -CertValue
-The value of the "asymmetric" credential type.
+Specifies the value of the "asymmetric" credential type.
 It represents the base 64 encoded certificate.
 
 ```yaml
@@ -231,7 +225,7 @@ Accept wildcard characters: False
 ```
 
 ### -ApplicationId
-The id of the application to add the credentials to.
+Specifies the ID of the application that this cmdlet adds the credentials to.
 
 ```yaml
 Type: String
@@ -253,9 +247,8 @@ Accept wildcard characters: False
 
 ## RELATED LINKS
 
-[Get-AzureRmADAppCredential]()
-
-[Remove-AzureRmADAppCredential]()
+[Get-AzureRmADAppCredential](./Get-AzureRmADAppCredential.md)
 
-[Get-AzureRmADApplication]()
+[Remove-AzureRmADAppCredential](./Remove-AzureRmADAppCredential.md)
 
+[Get-AzureRmADApplication](./Get-AzureRmADApplication.md)