New-PCCustomer.md

New-PCCustomer

Creates a new customer.

SYNTAX

New-PCCustomer -Email <String> -Culture <String> -Language <String> -CompanyName <String> -Country <String> -Region <String> -City <String> -State <String> -AddressLine1 <String> -PostalCode <String> -FirstName <String> -LastName <String> -PhoneNumber <String> -Domain <String> [-SaToken <String>] [<CommonParameters>]

New-PCCustomer -BillingProfile <BillingProfile> -CompanyProfile <CompanyProfile> [-SaToken <String>] [<CommonParameters>]

DESCRIPTION

The New-PCCustomer cmdlet creates a new customer for the current partner.

PARAMETERS

-Email <String>

Specifies the contact email address for the new customer.

Required?                    true
Position?                    named
Default value
Accept pipeline input?       false
Accept wildcard characters?  false

-Culture <String>

Specifies the culture for the new customer as an three letter ISO 3 country code.

Required?                    true
Position?                    named
Default value
Accept pipeline input?       false
Accept wildcard characters?  false

-Language <String>

Specifies the default language for the new customer.

Required?                    true
Position?                    named
Default value
Accept pipeline input?       false
Accept wildcard characters?  false

-CompanyName <String>

Specifies the company name for the new customer.

Required?                    true
Position?                    named
Default value
Accept pipeline input?       false
Accept wildcard characters?  false

-Country <String>

Specifies the country name for the new customer. The country must be valid for the current partner.

Required?                    true
Position?                    named
Default value
Accept pipeline input?       false
Accept wildcard characters?  false

-Region <String>

Specifies the region for the new customer.

Required?                    true
Position?                    named
Default value
Accept pipeline input?       false
Accept wildcard characters?  false

-City <String>

Specifies the city address for the new customer.

Required?                    true
Position?                    named
Default value
Accept pipeline input?       false
Accept wildcard characters?  false

-State <String>

Specifies the state address for the new customer.

Required?                    true
Position?                    named
Default value
Accept pipeline input?       false
Accept wildcard characters?  false

-AddressLine1 <String>

Specifies the first line of the address for the new customer.

Required?                    true
Position?                    named
Default value
Accept pipeline input?       false
Accept wildcard characters?  false

-PostalCode <String>

Specifies the postal code, if needed, for the new customer.

Required?                    true
Position?                    named
Default value
Accept pipeline input?       false
Accept wildcard characters?  false

-FirstName <String>

Specifies the the new customer's contact's first name.

Required?                    true
Position?                    named
Default value
Accept pipeline input?       false
Accept wildcard characters?  false

-LastName <String>

Specifies the the new customer's contact's last name.

Required?                    true
Position?                    named
Default value
Accept pipeline input?       false
Accept wildcard characters?  false

-PhoneNumber <String>

Specifies the the new customer's contact's phone number.

Required?                    true
Position?                    named
Default value
Accept pipeline input?       false
Accept wildcard characters?  false

-Domain <String>

Specifies the onmicrosoft.com for the new customer tenant.

Required?                    true
Position?                    named
Default value
Accept pipeline input?       false
Accept wildcard characters?  false

-BillingProfile <BillingProfile>

Specifies the billing profile.

Required?                    true
Position?                    named
Default value
Accept pipeline input?       false
Accept wildcard characters?  false

-CompanyProfile <CompanyProfile>

Specifies a company profile.

Required?                    true
Position?                    named
Default value
Accept pipeline input?       false
Accept wildcard characters?  false

-SaToken <String>

Specifies an authentication token with your Partner Center credentials.

Required?                    false
Position?                    named
Default value                $GlobalToken
Accept pipeline input?       false
Accept wildcard characters?  false

INPUTS

OUTPUTS

NOTES

EXAMPLES

EXAMPLE 1

Create a new customer.

$newDefaultAddress = New-PCCustomerDefaultAddress -Country '<Country code>' -Region '<region>' -City '<City>' -State '<State>' -AddressLine1 '<address1>' -PostalCode '<postal code>' -FirstName '<first name>' -LastName '<last name>' -PhoneNumber '<phone number>'
$newBillingProfile = New-PCCustomerBillingProfile -FirstName '<first name>' -LastName '<last name>' -Email '<Email>' -Culture '<ex: en.us>' -Language '<ex: en>' -CompanyName '<company name>' -DefaultAddress $newDefaultAddress
$newCompanyProfile = New-PCCustomerCompanyProfile -Domain '<company name>.onmicrosoft.com'
$newCustomer = New-PCCustomer -BillingProfile $newBillingProfile -CompanyProfile $newCompanyProfile