New-IvantiEmployee
SYNOPSIS
Creates a new employee in Ivanti ITSM.
SYNTAX
body (Default)
PrimaryEmail
New-IvantiEmployee -PrimaryEmail <String> -loginID <String> -location <String> -OrganizationalUnit <String>
-NetworkUserName <String> -status <String> [<CommonParameters>]
DESCRIPTION
Creates a new employee in Ivanti ITSM with the specified details such as primary email, login ID, location, organizational unit, network username, and status. Alternatively, a custom body hashtable can be provided to set the fields for the new employee.
EXAMPLES
EXAMPLE 1
New-Employee -PrimaryEmail '[email protected]' -loginID 'jdoe' -location 'HQ' -OrganizationalUnit 'IT' -NetworkUserName 'jdoe' -status 'Active'
Creates a new employee with the specified details.
EXAMPLE 2
New-Employee -body @{ 'PrimaryEmail' = '[email protected]'; 'loginID' = 'jdoe'; 'location' = 'HQ'; 'OrganizationalUnit' = 'IT'; 'NetworkUserName' = 'jdoe'; 'Status' = 'Active' }
Creates a new employee with the specified details in the body hashtable.
PARAMETERS
-body
A hashtable of fields to be set in the new employee.
Type: Hashtable
Parameter Sets: body
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-PrimaryEmail
The primary email address of the new employee.
Type: String
Parameter Sets: PrimaryEmail
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-loginID
The login ID of the new employee.
Type: String
Parameter Sets: PrimaryEmail
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-location
The location of the new employee.
Type: String
Parameter Sets: PrimaryEmail
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-OrganizationalUnit
The organizational unit of the new employee.
Type: String
Parameter Sets: PrimaryEmail
Aliases: OrgUnit
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-NetworkUserName
The network username of the new employee.
Type: String
Parameter Sets: PrimaryEmail
Aliases: SamAccountName
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-status
The status of the new employee. Valid values are 'Active', 'Terminated', 'On Leave'. Default is 'Active'.
Type: String
Parameter Sets: PrimaryEmail
Aliases:
Required: True
Position: Named
Default value: Active
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.