Partner Center PowerShell
Partner Center PowerShell is commonly used by partners to manage their Partner Center resources. Using this module you can perform tasks such as customer and subscription life cycle management, confirm customer acceptance of the Microsoft Customer Agreement, and purchase reserved instances.
Requirements
Partner Center PowerShell works with PowerShell 5.1 or higher on Windows, or PowerShell Core 6.x and later on all platforms. If you are not sure if you have PowerShell, or using macOS or Linux, install the latest version of PowerShell Core.
To check your PowerShell version, run the following command:
$PSVersionTable.PSVersion
To run Partner Center PowerShell using PowerShell 5.1 on Windows:
- Update to Windows PowerShell 5.1 if needed. If you are on Windows 10, you already have PowerShell 5.1 installed.
- Install .NET Framework 4.7.2 or later.
There are no additional requirements for Partner Center PowerShell when using PowerShell Core.
Install the Partner Center PowerShell module
The recommended install method is to only install for the active user:
Install-Module -Name PartnerCenter -AllowClobber -Scope CurrentUser
If you want to install for all users on a system, this requires administrator privileges. From an elevated PowerShell session either run as administrator or with the sudo
command on macOS or Linux:
Install-Module -Name PartnerCenter -AllowClobber -Scope AllUsers
By default, the PowerShell gallery is not configured as a trusted repository for PowerShellGet. The first time you use the PSGallery you see the following prompt:
Untrusted repository
You are installing the modules from an untrusted repository. If you trust this repository, change
its InstallationPolicy value by running the Set-PSRepository cmdlet.
Are you sure you want to install the modules from 'PSGallery'?
[Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "N"):
Answer Yes
or Yes to All
to continue with the installation.
Troubleshooting
Here are some common problems seen when installing the Partner Center PowerShell module. If you experience a problem not listed here, please file an issue on GitHub.
Proxy blocks connection
If you get errors from Install-Module
that indicate the PowerShell Gallery is unreachable, you may be behind a proxy. Different operating systems will have different requirements for configuring a system-wide proxy, which are not covered in detail here. Contact your system administrator for your proxy settings and how to configure them for your OS.
PowerShell itself may not be configured to use this proxy automatically. With PowerShell 5.1 and later, configure the proxy to use for a PowerShell session with the following command:
(New-Object System.Net.WebClient).Proxy.Credentials = `
[System.Net.CredentialCache]::DefaultNetworkCredentials
If your operating system credentials are configured correctly, this will route PowerShell requests through the proxy. In order to have this setting persist between sessions, add the command to a PowerShell profile.
In order to install the package, your proxy needs to allow HTTPS connections to the following address:
https://www.powershellgallery.com
Sign in
To start working with Partner Center PowerShell, sign in with your partner credentials.
Connect-PartnerCenter
Provide feedback
If you find a bug in Partner Center Powershell or have feedback, file an issue on GitHub.