< Back

Set-DUser

Mon Jan 13, 2020 6:47 pm

NAME Set-DUser



SYNOPSIS

Assigns an existing user to an OU in Delegate365.





SYNTAX

Set-DUser -Identity <string> [-OU <string>] [-UserPrincipalName <string>] [<CommonParameters>]





DESCRIPTION

Set-DUser assigns an existing user to an OU in Delegate365. An existing OU assignment is overwritten. If the user

is unassigned, he gets assigned. As parameters, the Identity and the OU name must be provided. The output shows

the user object and an operation status. For a successful operation, the Error property is False and the Message

property is empty.





PARAMETERS

-Identity <string>

Find a specific item. Wildcards are not supported, use the UserPrincipalName or the ID.



Required? true

Position? named

Default value

Accept pipeline input? true (ByValue, ByPropertyName)

Accept wildcard characters? false



-UserPrincipalName <string>

The UserPrincipalName can be used instead of the Identity parameter.



Required? false

Position? named

Default value

Accept pipeline input? true (ByValue, ByPropertyName)

Accept wildcard characters? false



-OU <string>

Setting the OU name assigns the user to that OU.



Required? false

Position? named

Default value

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

System.String

Find a specific item. Wildcards are not supported, use the UserPrincipalName or the ID.



System.String

The UserPrincipalName can be used instead of the Identity parameter.





OUTPUTS

Delegate365.Api.Core.Models.SetUserAssign[]





---------- EXAMPLE 1 ----------



Set-DUser -Identity support@delegate365.com -OU Chicago



Assign a user to an OU. The Identity must be provided by UserPrincipalName or by ID.

---------- EXAMPLE 2 ----------



Set-DUser -UserPrincipalName support@delegate365.com -OU Chicago



Alternatively, use the UserPrincipalName parameter.



RELATED LINKS

Delegate365 support https://support.delegate365.com/