Skip to content
This repository was archived by the owner on Jul 22, 2024. It is now read-only.

Commit 43fca7f

Browse files
idwilliams-2joelst
authored andcommitted
Minor updates to the documentation and module manifest files (#66)
* Minor updates to the documentation and module manifest files * Update README.md
1 parent d1c7781 commit 43fca7f

4 files changed

Lines changed: 22 additions & 120 deletions

File tree

README.md

Lines changed: 14 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,11 @@ This repository contains a set of PowerShell commands for administrators and dev
1111
Run the following command in an elevated PowerShell session to install the Partner Center module:
1212

1313
```powershell
14+
# Install the Partner Center PowerShell module
1415
Install-Module -Name PartnerCenter
16+
17+
# Install the Partner Center PowerShell module for PowerShell Core
18+
Install-Module -Name PartnerCenter.NetCore
1519
```
1620

1721
If you have an earlier version of the Partner Center PowerShell modules installed from the PowerShell Gallery and would like to update to the latest version, run the following commands from an elevated PowerShell session.
@@ -21,6 +25,9 @@ If you have an earlier version of the Partner Center PowerShell modules installe
2125
```powershell
2226
# Install the latest version of the Partner Center PowerShell module
2327
Update-Module -Name PartnerCenter
28+
29+
# Install the latest version of the Partner Center PowerShell module for PowerShell Core
30+
Update-Module -Name PartnerCenter.NetCore
2431
```
2532

2633
## Usage
@@ -31,28 +38,24 @@ To connect to Partner Center, use the [`Connect-PartnerCenter`](docs/help/Connec
3138

3239
#### Service Principal
3340

34-
The following example demonstrates how to connect using a service principal. Using this approach will leverage the app only authentication flow. It is important to note that not all Partner Center operations support this type of authentication. If you have not already created an Azure AD application then please follow the steps documented in the [Web App](#Web-App) section below.
41+
The following example demonstrates how to connect using a service principal. It is important to note that not all Partner Center operations support this type of authentication. If you have not already created an Azure AD application, then follow the steps documented in the [Web App](#Web-App) section below.
3542

3643
```powershell
3744
# Service principal login
3845
$appId = '<Web-AAD-AppId-for-PartnerCenter>'
3946
$appSecret = '<Web-AAD-AppSecret>' | ConvertTo-SecureString -AsPlainText -Force
4047
$credential = New-Object System.Management.Automation.PSCredential $appId $appSecret
4148
42-
Connect-PartnerCenter -Credential $credential -ServicePrincipal -TenantId '<TenantId>
49+
Connect-PartnerCenter -Credential $credential -ServicePrincipal -TenantId '<TenantId>'
4350
```
4451

4552
#### User Credentials
4653

47-
The following examples demonstrate how to connect using user credentials. Using this approach will leverage the app + user authentication flow. If you have not already configured an Azure AD application for use with this command then please see the steps documented in the [Native App](#Native-App) section below.
54+
The following examples demonstrate how to connect using user credentials. Using this approach will leverage app + user authentication. If you have not already configured an Azure AD application for use with this command then, see the steps documented in the [Native App](#Native-App) section below.
4855

4956
```powershell
5057
# Interactive login - a dialog box will appear for you to provide your Partner Center credentials
5158
Connect-PartnerCenter -ApplicationId '<Native-AAD-AppId-for-PartnerCenter>'
52-
53-
# Non-interactive login
54-
$PSCredential = Get-Credential
55-
Connect-PartnerCenter -ApplicationId '<Native-AAD-AppId-for-PartnerCenter>' -Credential $PSCredential
5659
```
5760

5861
#### Access Token
@@ -62,11 +65,11 @@ The following example demonstrates how to connect using an access token. It is i
6265
```powershell
6366
$appId = '<AAD-AppId-for-PartnerCenter>'
6467
$appSecret = '<AAD-AppSecret>' | ConvertTo-SecureString -AsPlainText -Force
65-
$PSCredential = New-Object System.Management.Automation.PSCredential $appId $appSecret
68+
$PSCredential = New-Object System.Management.Automation.PSCredential $appId, $appSecret
6669
6770
$token = New-PartnerAccessToken -Credential $PSCredential -ServicePrincipal -TenantId '<TenantId>'
6871
69-
Connect-PartnerCenter -AccessToken $token.AccessToken -AccessTokenExpiresOn $token.ExpiresOn -ApplicationId '<AAD-AppId-for-PartnerCenter>' -TenantId '<TenantId>'
72+
Connect-PartnerCenter -AccessToken $token.AccessToken -ApplicationId '<AAD-AppId-for-PartnerCenter>' -TenantId '<TenantId>'
7073
```
7174

7275
#### Sovereign Cloud
@@ -112,7 +115,7 @@ Get-Help -Name Get-PartnerCustomer -Full
112115
1. Sign in to the [Partner Center](https://partner.microsoft.com/cloud-solution-provider/csp-partner) using credentials that have *Admin Agent* and *Global Admin* privileges
113116
2. Click on _Dashboard_ at the top of the page, then click on the cog icon in the upper right, and then click the _Partner settings_.
114117
3. Add a new native application if one does not exist already.
115-
4. Sign in to the [Azure management portal](https://portal.azure.com) using the same credentials from step 1.
118+
4. Sign in to the [classic portal](https://portal.azure.com) using the same credentials from step 1.
116119
5. Click on the _Azure Active Directory_ icon in the toolbar.
117120
6. Click _App registrations_ -> Select _All apps_ from the drop down -> Click on the application created in step 3.
118121
7. Click _Settings_ and then click _Redirect URIs_
@@ -122,4 +125,4 @@ Get-Help -Name Get-PartnerCustomer -Full
122125

123126
1. Sign in to the [Partner Center](https://partner.microsoft.com/cloud-solution-provider/csp-partner) using credentials that have *Admin Agent* and *Global Admin* privileges
124127
2. Click on _Dashboard_ at the top of the page, then click on the cog icon in the upper right, and then click the _Partner settings_.
125-
3. Add a new web application if one does not exist already.
128+
3. Add a new web application if one does not exist already.

src/PartnerCenter/Extensions/SecureAppCredentials.cs

Lines changed: 0 additions & 101 deletions
This file was deleted.

src/PowerShell/PartnerCenter.NetCore.psd1

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,9 @@
11
#
2-
# Module manifest for module 'PartnerCenter'
2+
# Module manifest for module 'PartnerCenter.NetCore'
33
#
44
# Generated by: Microsoft Corporation
55
#
6-
# Generated on: 02/01/2019
6+
# Generated on: 02/04/2019
77
#
88

99
@{
@@ -63,7 +63,7 @@
6363
# ScriptsToProcess = @()
6464

6565
# Type files (.ps1xml) to be loaded when importing this module
66-
# TypesToProcess = 'Microsoft.Store.PartnerCenter.PowerShell.types.ps1xml'
66+
# TypesToProcess = @()
6767

6868
# Format files (.ps1xml) to be loaded when importing this module
6969
FormatsToProcess = 'Microsoft.Store.PartnerCenter.PowerShell.format.ps1xml'
@@ -196,10 +196,10 @@
196196
# IconUri = ''
197197

198198
# ReleaseNotes of this module
199-
ReleaseNotes = ''
199+
ReleaseNotes = 'Initial release'
200200

201201
# Prerelease string of this module
202-
Prerelease = 'preview'
202+
# Prerelease = 'preview'
203203

204204
# Flag to indicate whether the module requires explicit user acceptance for install/update
205205
# RequireLicenseAcceptance = $false

src/PowerShell/PartnerCenter.psd1

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@
33
#
44
# Generated by: Microsoft Corporation
55
#
6-
# Generated on: 02/01/2019
6+
# Generated on: 02/04/2019
77
#
88

99
@{
@@ -63,7 +63,7 @@
6363
# ScriptsToProcess = @()
6464

6565
# Type files (.ps1xml) to be loaded when importing this module
66-
# TypesToProcess = 'Microsoft.Store.PartnerCenter.PowerShell.types.ps1xml'
66+
# TypesToProcess = @()
6767

6868
# Format files (.ps1xml) to be loaded when importing this module
6969
FormatsToProcess = 'Microsoft.Store.PartnerCenter.PowerShell.format.ps1xml'
@@ -196,7 +196,7 @@
196196
# IconUri = ''
197197

198198
# ReleaseNotes of this module
199-
ReleaseNotes = ''
199+
ReleaseNotes = 'Added the ability to get offer categories. Retired the Get-PartnerCustomerRelationship command. Removed the ability to pass user credentials when connecting due to security changes with the Partner Center API.'
200200

201201
# Prerelease string of this module
202202
# Prerelease = 'preview'

0 commit comments

Comments
 (0)