Add-MgmtSvcUser

Creates a user in Windows Azure Pack.

Syntax

Add-MgmtSvcUser [-AdminUri] <Uri> [-Token] <String> [-Name] <String> [-Email] <String> [[-State] <UserState>]
 [[-ActivationSyncState] <ActivationSyncState>] [-Confirm] [-DisableCertificateValidation] [-WhatIf]
 [<CommonParameters>]
Add-MgmtSvcUser [-AdminUri] <Uri> [-Token] <String> [[-User] <User>] [-Confirm] [-DisableCertificateValidation]
 [-WhatIf] [<CommonParameters>]

Description

The Add-MgmtSvcUser cmdlet creates a user in Windows Azure Pack for Windows Server.

Examples

Example 1: Add a user

PS C:\> Add-MgmtSvcUser -AdminUri "https://Computer01:30004" -Token $Token -Name "Patti Fuller" -Email "PattiFuller@Contoso.com" -State "Active" -ActivationSyncState "InSync"
NOTE: This example assumes that you have created a token by using **Get-MgmtSvcToken** and have stored it in a variable named $Token. This command adds the user named Patti Fuller.

Parameters

-ActivationSyncState

Specifies the activation synchronization state.
Valid values are:

- InSync
- Synching
- OutOfSync

Type:ActivationSyncState
Parameter Sets:InSync, Syncing, OutOfSync
Required:False
Position:5
Default value:None
Accept pipeline input:True (ByPropertyName)
Accept wildcard characters:False

-AdminUri

Specifies the URI of the Windows Azure Pack administrator API.
Use the following format: https://<computer>:<port>, where <computer> is the computer on which the administrator API is installed.

Type:Uri
Required:True
Position:0
Default value:None
Accept pipeline input:True (ByPropertyName)
Accept wildcard characters:False

-Confirm

Prompts you for confirmation before running the cmdlet.

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

-DisableCertificateValidation

Disables certificate validation for the Windows Azure Pack installation.

If you specify this parameter, you can use self-signed certificates.

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

-Email

Specifies the email address for the user.

Type:String
Required:True
Position:3
Default value:None
Accept pipeline input:True (ByPropertyName)
Accept wildcard characters:False

-Name

Specifies a name for the user.

Type:String
Required:True
Position:2
Default value:None
Accept pipeline input:True (ByPropertyName)
Accept wildcard characters:False

-State

Specifies a state for the user.
Valid values are:

- PendingValidation
- Active
- Suspended
- DeletePending

Type:UserState
Parameter Sets:PendingValidation, Active, Suspended, DeletePending
Required:False
Position:4
Default value:None
Accept pipeline input:True (ByPropertyName)
Accept wildcard characters:False

-Token

Specifies an identity token.
To create a token, use the Get-MgmtSvcToken cmdlet.

Type:String
Required:True
Position:1
Default value:None
Accept pipeline input:True (ByPropertyName)
Accept wildcard characters:False

-User

Specifies a user object.

Type:User
Required:False
Position:2
Default value:None
Accept pipeline input:True (ByValue)
Accept wildcard characters:False

-WhatIf

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

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