< Back

Set-PartnerCustomerUser

Sat Jan 18, 2020 6:37 pm

NAME Set-PartnerCustomerUser



SYNOPSIS

Updates the specified customer user account.





SYNTAX

Set-PartnerCustomerUser [-CustomerId] <String> [-DisplayName <String>] [-FirstName <String>]

[-ForceChangePasswordNextLogin] -InputObject <PSCustomerUser> [-LastName <String>] [-Password <SecureString>]

[-UsageLocation <String>] [-UserPrincipalName <String>] [-Confirm] [-WhatIf] [<CommonParameters>]



Set-PartnerCustomerUser [-CustomerId] <String> [-DisplayName <String>] [-FirstName <String>]

[-ForceChangePasswordNextLogin] [-LastName <String>] [-Password <SecureString>] [-UsageLocation <String>] -UserId

<String> [-UserPrincipalName <String>] [-Confirm] [-WhatIf] [<CommonParameters>]





DESCRIPTION

The Set-PartnerCustomerUser cmdlet modifies a customer user account.





PARAMETERS

-CustomerId <String>

Identifier for the customer.



Required? true

Position? 0

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-DisplayName <String>

User's display name.



Required? false

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-FirstName <String>

User's first name.



Required? false

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-ForceChangePasswordNextLogin [<SwitchParameter>]

Forces user to change password during next login.



Required? false

Position? named

Default value False

Accept pipeline input? False

Accept wildcard characters? false



-InputObject <PSCustomerUser>

The customer user object to be modified.



Required? true

Position? named

Default value None

Accept pipeline input? True (ByValue)

Accept wildcard characters? false



-LastName <String>

User's last name.



Required? false

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-Password <SecureString>

User's new password.



Required? false

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-UsageLocation <String>

The usage location, the location where user intends to use the license.



Required? false

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-UserId <String>

Identifier for the user.



Required? true

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-UserPrincipalName <String>

User principal name.



Required? false

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-Confirm [<SwitchParameter>]

Prompts you for confirmation before running the cmdlet.



Required? false

Position? named

Default value False

Accept pipeline input? False

Accept wildcard characters? false



-WhatIf [<SwitchParameter>]

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



Required? false

Position? named

Default value False

Accept pipeline input? False

Accept wildcard characters? false



<CommonParameters>

This cmdlet supports the common parameters: Verbose, Debug,

ErrorAction, ErrorVariable, WarningAction, WarningVariable,

OutBuffer, PipelineVariable, and OutVariable. For more information, see

about_CommonParameters (https:/go.microsoft.com/fwlink/?LinkID=113216).



INPUTS

Microsoft.Store.PartnerCenter.PowerShell.Models.Users.PSCustomerUser







OUTPUTS

Microsoft.Store.PartnerCenter.PowerShell.Models.Users.PSCustomerUser







NOTES









-------------------------- Example 1 --------------------------



PS C:\\> Set-PartnerCustomerUser -CustomerId 46a62ece-10ad-42e5-b3f1-b2ed53e6fc08 -UserId

a9ef48bb-8758-4590-a312-d4a47bfaded4 -LastName 'Sullivan'



Modify the user's last name





-------------------------- Example 2 --------------------------



$password = '<Password>'

PS C:\\>$passwordSecure = $password | ConvertTo-SecureString -AsPlainText -Force

PS C:\\>Set-PartnerCustomerUser -CustomerId 46a62ece-10ad-42e5-b3f1-b2ed53e6fc08 -UserId

a9ef48bb-8758-4590-a312-d4a47bfaded4 -Password $passwordSecure -ForceChangePassword $true



Set the password for the user account and require the user to change the password during the next sign on.







RELATED LINKS

Online Version: https://docs.microsoft.com/powershell/m ... stomerUser