Set-GitLabUser.ps1
|
function Set-GitLabUser { <# .SYNOPSIS Set properties on specified user. .DESCRIPTION The Set-GitlabUser function sets properties on the specified user. returns modified user when -PassThru is specified .EXAMPLE Set-GitLabUser -id 1 -bio 'awesome root acocunt' --------------------------------------------------------------- Sets the bio of user with id 1 to awesome root account .EXAMPLE #> [CmdletBinding()] [Alias()] [OutputType()] Param ( #ID of yhe user [Parameter(HelpMessage = 'User ID', Mandatory = $true)] [Alias('ID')] [int]$UserID, #Email of the user [Parameter(HelpMessage = 'Email for user')] [ValidateScript({ if($_ -match "^[a-z0-9!#$%&'*+/=?^_`{|}~-]+(?:\.[a-z0-9!#$%&'*+/=?^_`{|}~-]+)*@(?:[a-z0-9](?:[a-z0-9-]*[a-z0-9])?\.)+[a-z0-9](?:[a-z0-9-]*[a-z0-9])$") { $true } else { Throw "$_ is not a valid email address" } })] [string]$Email, #Password of the user [Parameter(HelpMessage = 'password user')] [ValidatePattern('(?# Error: Password Must Contain at least 8 characters).{8,}')] [ValidateScript({ if($_ -match "^.{8,}$") { $true } else { Throw 'Password Must Contain at least 8 characters' } })] [string]$Password, #Username of the user [Parameter(HelpMessage = 'users username')] [string]$UserName, #Name of the user [Parameter(HelpMessage = 'users name')] [string]$Name, #Skype ID of the user [Parameter(HelpMessage = 'users Skype ID', Mandatory = $false)] [string]$Skype, #LinkedIn of the user [Parameter(HelpMessage = 'users LinkedIn ID', Mandatory = $false)] [string]$LinkedIn, #Twitter Accountof the user [Parameter(HelpMessage = 'users Twitter Account', Mandatory = $false)] [string]$Twitter, #Website URL of the user [Parameter(HelpMessage = 'users Website URL', Mandatory = $false)] [string]$WebsiteURL, #Organisation of the user [Parameter(HelpMessage = 'users Organisation', Mandatory = $false)] [string]$Organization, #Number of projects user can create [Parameter(HelpMessage = 'Number of projects user can create', Mandatory = $false)] [int]$ProjectsLimit, #External UID of the user [Parameter(HelpMessage = 'users External UID', Mandatory = $false)] [string]$ExternUID, #external providers name of the user [Parameter(HelpMessage = 'users external provider name', Mandatory = $false)] [string]$Provider, #User's biography [Parameter(HelpMessage = "User's biography", Mandatory = $false)] [ValidateScript({ if($_ -match "^.{0,250}$") { $true } else { Throw 'Bio must contain at most 250 characters' } })] [string]$Bio, #Location of the user [Parameter(HelpMessage = 'users Location', Mandatory = $false)] [String]$Location, #User is admin [Parameter(HelpMessage = 'User is admin', Mandatory = $false)] [Boolean]$Admin, #User can create groups [Parameter(HelpMessage = 'can create groups', Mandatory = $false)] [Boolean]$CanCreateGroup, #Flags the user as external [Parameter(HelpMessage = 'Flags the user as external', Mandatory = $false)] [Boolean]$External, # Existing GitlabConnector Object, can be retrieved with Get-GitlabConnect [Parameter(HelpMessage = 'Specify Existing GitlabConnector', Mandatory = $false, DontShow = $true)] [psobject]$GitlabConnect = (Get-GitLabConnect), # Passthru the created project [Parameter(HelpMessage = 'Passthru the created project', Mandatory = $false)] [switch]$PassThru ) $httpmethod = 'put' $apiurl = "users/$UserID" $parameters = @{} #email - Email if($Email) { $parameters.email = $Email } #password - Password if($Password) { $parameters.password = $Password } #username - Username if($UserName) { $parameters.username = $UserName } #name - Name if($Name) { $parameters.name = $Name } #skype (optional) - Skype ID if($Skype) { $parameters.'skype' = $Skype } #linkedin (optional) - LinkedIn if($LinkedIn) { $parameters.'linkedin' = $LinkedIn } #twitter (optional) - Twitter account if($Twitter) { $parameters.'twitter' = $Twitter } #website_url (optional) - Website URL if($WebsiteURL) { $parameters.'website_url' = $WebsiteURL } #organization (optional) - Organization name if($Organization) { $parameters.'organisation' = $Organization } #projects_limit (optional) - Number of projects user can create if($ProjectsLimit) { $parameters.'projects_limit' = $ProjectsLimit } #extern_uid (optional) - External UID if($ExternUID) { $parameters.'extern_uid' = $ExternUID } #provider (optional) - External provider name if($Provider) { $parameters.'provider' = $Provider } #bio (optional) - User's biography if($PSCmdlet.MyInvocation.BoundParameters.keys -contains 'Bio') { $parameters.'bio' = $Bio.ToString() } #location (optional) - User's location if($Location) { $parameters.'location' = $Location } #admin (optional) - User is admin if($PSCmdlet.MyInvocation.BoundParameters.keys -contains 'Admin') { if($Admin) { $parameters.admin = 'true' } else { $parameters.admin = 'false' } } #can_create_group (optional) - User can create groups if($PSCmdlet.MyInvocation.BoundParameters.keys -contains 'CanCreateGroup') { if($CanCreateGroup) { $parameters.'can_create_group' = 'true' } else { $parameters.'can_create_group' = 'false' } } #external (optional) - Flags the user as external if($PSCmdlet.MyInvocation.BoundParameters.keys -contains 'External') { if($External) { $parameters.'external' = 'true' } else { $parameters.'external' = 'false' } } $modusr = $GitlabConnect.callapi($apiurl,$httpmethod,$parameters) if($PassThru) { return $modusr } } |