Share via


New-PartnerCustomer

Creates a new customer.

Syntax

New-PartnerCustomer
   [-AssociatedPartnerId <String>]
   -BillingAddressLine1 <String>
   [-BillingAddressLine2 <String>]
   [-BillingAddressCity <String>]
   -BillingAddressCountry <String>
   [-BillingAddressPostalCode <String>]
   [-BillingAddressRegion <String>]
   [-BillingAddressState <String>]
   [-ContactEmail <String>]
   [-ContactFirstName <String>]
   [-ContactLastName <String>]
   [-ContactPhoneNumber <String>]
   [-Culture <String>]
   -Domain <String>
   -Language <String>
   -Name <String>
   [-DisableValidation]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Creates a new customer.

Examples

Example 1

PS C:\> New-PartnerCustomer -BillingAddressLine1 '1 Microsoft Way' -BillingAddressCity 'Redmond' -BillingAddressCountry 'US' -BillingAddressPostalCode '98052' -BillingAddressState 'WA' -ContactEmail 'jdoe@customer.com' -ContactFirstName 'Jane' -ContactLastName 'Doe' -Culture 'en-US' -Domain 'newcustomer.onmicrosoft.com' -Language 'en' -Name 'New Customer'

Creates a new customer.

Parameters

-AssociatedPartnerId

The associated partner identifier. Used if creating a customer for an indirect reseller.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-BillingAddressCity

The city of the customer's billing address.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-BillingAddressCountry

The country of the customer's billing address.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-BillingAddressLine1

The first line of the customer's billing address.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-BillingAddressLine2

The second line of the customer's billing address.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-BillingAddressPostalCode

The postal code of the customer's billing address.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-BillingAddressRegion

The region of the customer's billing address.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-BillingAddressState

The state of the customer's billing address.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Prompts you for confirmation before running the cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ContactEmail

The email address of the primary contact of the customer.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ContactFirstName

The first name of the primary contact of the customer.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ContactLastName

The last name of the primary contact of the customer.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ContactPhoneNumber

The phone number of the primary contact of the customer.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Culture

The preferred culture for communication and currency.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisableValidation

A flag that indicates whether the additional client side validation should be disabled.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Domain

The customer's domain name, such as contoso.onmicrosoft.com. 27 characters maximum domain prefix + 16 maximum characters suffix for '.onmicrosoft.com'

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Language

The default language. Two character language codes (e.g., en, fr) are supported.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Name

The name of the customer to be created.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Inputs

None

Outputs

Microsoft.Store.PartnerCenter.PowerShell.Models.Customers.PSCustomer