ctxal-sdk

0.3.14

Public/Set-ALAdminUser.ps1

Function Set-ALAdminUser {
  <#
.SYNOPSIS
  Sets Administrator User Password
.DESCRIPTION
  Sets Administrator User Password
.PARAMETER websession
  Existing Webrequest session for ELM Appliance
.PARAMETER Password
  New Password for the User
.EXAMPLE
  Set-ALAdminUser -websession $websession -Password $PlainPassword -Verbose
#>
  [cmdletbinding(SupportsShouldProcess = $true, ConfirmImpact = "High")]
  Param(
    [Parameter(Mandatory = $true)]$websession,
    [Parameter(Mandatory = $false)][string]$Password
  )

  Begin {
    Write-Verbose "BEGIN: $($MyInvocation.MyCommand)"
    Test-ALWebsession -WebSession $websession
  }

  Process {
    [xml]$xml = @"
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
  <s:Body xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
    <EditDirectoryItem xmlns="http://www.unidesk.com/">
      <command>
        <DirectoryItem xsi:type="UserChanges">
            <ItemId xsi:type="UserId">
                <UnideskId>294912</UnideskId>
                <DirectoryJunctionId>0</DirectoryJunctionId>
                <LdapGuid />
                <LdapDN />
                <Sid />
            </ItemId>
            <Roles>
                <long>163847</long>
            </Roles>
            <Name>Administrator</Name>
            <Email />
            <LastName>Administrator</LastName>
            <Phone />
            <Address1 />
            <Address2 />
            <Title />
            <City />
            <State />
            <PostalCode />
            <Country />
            <LoginName>Administrator</LoginName>
            <Password>$Password</Password>
            </DirectoryItem>
            <Reason>
                <ReferenceNumber>0</ReferenceNumber>
            </Reason>
      </command>
    </EditDirectoryItem>
  </s:Body>
</s:Envelope>
"@
    Write-Verbose $xml
    $headers = @{
      SOAPAction     = "http://www.unidesk.com/EditDirectoryItem";
      "Content-Type" = "text/xml; charset=utf-8";
      UNIDESK_TOKEN  = $websession.token;
    }

    $url = "https://" + $websession.aplip + "/Unidesk.Web/API.asmx"
    if ($PSCmdlet.ShouldProcess("Setting Administrator Password")) {
      $return = Invoke-WebRequest -Uri $url -Method Post -Body $xml -Headers $headers -WebSession $websession
      [xml]$obj = $return.Content

      if ($obj.Envelope.Body.EditDirectoryItemResponse.EditDirectoryItemResult.Error) {
        throw $obj.Envelope.Body.EditDirectoryItemResponse.EditDirectoryItemResult.Error.message
      }
      else {
        return $obj.Envelope.Body.EditDirectoryItemResponse.EditDirectoryItemResult.id
      }
    }
  }

  end { Write-Verbose "END: $($MyInvocation.MyCommand)" }
}