New-MceUser

SYNOPSIS#

Creates a new MCE user.

SYNTAX#

Pipe#

New-MceUser [[-Name] <String>] [[-IsEnabled] <Boolean>] [-ObjectGuid] <Guid> [<CommonParameters>]

Properties#

New-MceUser [[-Name] <String>] [[-IsEnabled] <Boolean>] [-LinkedUserIdentities] <Array> [<CommonParameters>]

DESCRIPTION#

This cmdlet creates a new user on the system, and returns the user's ID.

The cmdlet is designed to support pipelining from Microsoft.ActiveDirectory.Management.ADUser instances to create users linked to Active Directory identities.

EXAMPLES#

EXAMPLE 1#

New-MceUser

Creates a default disabled user.

EXAMPLE 2#

New-MceUser -IsEnabled

Creates an enabled user.

EXAMPLE 3#

New-MceUser -DisplayName "testuser" -ObjectGuid 12345678-1234-1234-1234-123456789012 -IsEnabled $true

Creates an enabled user with the display name "testuser" and IDAM Guid "12345678-1234-1234-1234-123456789012"

EXAMPLE 4#

Get-AdUser -Filter 'Name -Like "Harry*"' | New-MceUser -IsEnabled $true

Creates an enabled user for every guid returned by the Get-AdUser cmdlet.

PARAMETERS#

-Name#

The user display name.

This value is optional, since the user display name may be synchronized from external identity provider. Additionally, if synchronized from an external provider, the display name value provided here will be overridden.

Type: String
Parameter Sets: (All)
Aliases: DisplayName
Required: False
Position: 0
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-IsEnabled#

A value indicating whether the user is enabled.

Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: 1
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

-ObjectGuid#

The objectGuid property of an associated identity in Active Directory.

Setting this property adds a linked identity.

This property is designed for pipelining from Microsoft Active Directory cmdlets.

Type: Guid
Parameter Sets: Pipe
Aliases:
Required: True
Position: 2
Default value: 00000000-0000-0000-0000-000000000000
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-LinkedUserIdentities#

The linked user identities.

Type: Array
Parameter Sets: Properties
Aliases:
Required: True
Position: 2
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

CommonParameters#

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

INPUTS#

System.String#

The user display name.

This value is optional, since the user display name may be synchronized from external identity provider. Additionally, if synchronized from an external provider, the display name value provided here will be overridden.

System.Guid#

The objectGuid property of an associated identity in Active Directory.

Setting this property adds a linked identity.

This property is designed for pipelining from Microsoft Active Directory cmdlets.

OUTPUTS#

System.String#

NOTES#

RELATED LINKS#

MindLink Docs