Updating the documentation (#219)

Author: Isaiah Williams

azure-pipelines.yml

@@ -75,6 +75,14 @@ steps:
     PoliCheck: true
   condition: and(succeeded(), eq(variables['Agent.OS'], 'Windows_NT'))
 
+- task: UseDotNet@2
+  displayName: 'Use .NET Core 2.2'
+  inputs:
+    packageType: sdk
+    version: 2.2.x
+    installationPath: $(Agent.ToolsDirectory)/dotnet
+  condition: and(succeeded(), eq(variables['Agent.OS'], 'Windows_NT'), eq(variables['Build.SourceBranch'], 'refs/heads/master'))
+
 - task: SFP.build-tasks.custom-build-task-1.EsrpCodeSigning@1
   displayName: 'ESRP code signing'
   inputs:

docs/help/New-PartnerAccessToken.md

@@ -21,16 +21,16 @@ New-PartnerAccessToken -AccessToken <String> -ApplicationId <String> [-Credentia
  [-UseAuthorizationCode] [<CommonParameters>]
 ```
 
-### ServicePrincipalCertificate
+### ServicePrincipal
 ```powershell
-New-PartnerAccessToken -ApplicationId <String> -CertificateThumbprint <String> [-Environment <EnvironmentName>]
+New-PartnerAccessToken -ApplicationId <String> -Credential <PSCredential> [-Environment <EnvironmentName>]
  [-RefreshToken <String>] -Scopes <String[]> [-ServicePrincipal] -Tenant <String> [-UseAuthorizationCode]
  [<CommonParameters>]
 ```
 
-### ServicePrincipal
+### ServicePrincipalCertificate
 ```powershell
-New-PartnerAccessToken -ApplicationId <String> -Credential <PSCredential> [-Environment <EnvironmentName>]
+New-PartnerAccessToken -ApplicationId <String> -CertificateThumbprint <String> [-Environment <EnvironmentName>]
  [-RefreshToken <String>] -Scopes <String[]> [-ServicePrincipal] -Tenant <String> [-UseAuthorizationCode]
  [<CommonParameters>]
 ```
@@ -41,6 +41,12 @@ New-PartnerAccessToken -ApplicationId <String> [-Environment <EnvironmentName>]
  -Scopes <String[]> [-Tenant <String>] [-UseAuthorizationCode] [-UseDeviceAuthentication] [<CommonParameters>]
 ```
 
+### ByModule
+```powershell
+New-PartnerAccessToken [-Environment <EnvironmentName>] -Module <ModuleName> [-RefreshToken <String>]
+ [-Tenant <String>] [-UseAuthorizationCode] [<CommonParameters>]
+```
+
 ## DESCRIPTION
 Acquires an access token from Azure Active Directory.
 
@@ -87,7 +93,7 @@ The application identifier to be used during authentication.
 
 ```yaml
 Type: String
-Parameter Sets: (All)
+Parameter Sets: AccessToken, ServicePrincipal, ServicePrincipalCertificate, User
 Aliases: ClientId
 
 Required: True
@@ -155,6 +161,22 @@ Accept pipeline input: False
 Accept wildcard characters: False
 ```
 
+### -Module
+The module that an access token is being generated.
+
+```yaml
+Type: ModuleName
+Parameter Sets: ByModule
+Aliases: ModuleName
+Accepted values: ExchangeOnline
+
+Required: True
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
 ### -RefreshToken
 The refresh token to use during authentication.
 
@@ -175,7 +197,7 @@ Scopes requested to access a protected API.
 
 ```yaml
 Type: String[]
-Parameter Sets: (All)
+Parameter Sets: AccessToken, ServicePrincipal, ServicePrincipalCertificate, User
 Aliases:
 
 Required: True
@@ -190,10 +212,10 @@ Indicates that this account authenticates by providing service principal credent
 
 ```yaml
 Type: SwitchParameter
-Parameter Sets: ServicePrincipalCertificate
+Parameter Sets: ServicePrincipal
 Aliases:
 
-Required: False
+Required: True
 Position: Named
 Default value: None
 Accept pipeline input: False
@@ -202,10 +224,10 @@ Accept wildcard characters: False
 
 ```yaml
 Type: SwitchParameter
-Parameter Sets: ServicePrincipal
+Parameter Sets: ServicePrincipalCertificate
 Aliases:
 
-Required: True
+Required: False
 Position: Named
 Default value: None
 Accept pipeline input: False
@@ -217,7 +239,7 @@ The identifier of the Azure AD tenant.
 
 ```yaml
 Type: String
-Parameter Sets: AccessToken, User
+Parameter Sets: AccessToken, User, ByModule
 Aliases: Domain, TenantId
 
 Required: False
@@ -229,7 +251,7 @@ Accept wildcard characters: False
 
 ```yaml
 Type: String
-Parameter Sets: ServicePrincipalCertificate, ServicePrincipal
+Parameter Sets: ServicePrincipal, ServicePrincipalCertificate
 Aliases: Domain, TenantId
 
 Required: True

docs/help/PartnerCenter.md

@@ -267,7 +267,7 @@ Confirms the customer acceptance of the Microsoft Cloud agreement.
 Creates a new application consent for the specified customer.
 
 ### [New-PartnerCustomerCart](New-PartnerCustomerCart.md)
-Creates an order for a customer.
+Creates a cart for a customer.
 
 ### [New-PartnerCustomerConfigurationPolicy](New-PartnerCustomerConfigurationPolicy.md)
 Creates a new configuration policy for the specified customer.

src/PowerShell/Commands/NewPartnerAccessToken.cs

@@ -109,7 +109,7 @@ public class NewPartnerAccessToken : PartnerAsyncCmdlet
         [Parameter(HelpMessage = "Scopes requested to access a protected API.", Mandatory = true, ParameterSetName = AccessTokenParameterSet)]
         [Parameter(HelpMessage = "Scopes requested to access a protected API.", Mandatory = true, ParameterSetName = ServicePrincipalParameterSet)]
         [Parameter(HelpMessage = "Scopes requested to access a protected API.", Mandatory = true, ParameterSetName = ServicePrincipalCertificateParameterSet)]
-        [Parameter(HelpMessage = "Scopes requested to access a protected API.", Mandatory = false, ParameterSetName = UserParameterSet)]
+        [Parameter(HelpMessage = "Scopes requested to access a protected API.", Mandatory = true, ParameterSetName = UserParameterSet)]
         public string[] Scopes { get; set; }
 
         /// <summary>