Skip to main content

Tab Role Order

Generated Cmdlet Help

This page has been generated from the NinjaOne PowerShell module source. To make changes please edit the appropriate PowerShell source file.

SYNOPSIS​

Updates the order of custom tabs for a specific role.

SYNTAX​

Set-NinjaOneTabRoleOrder [-roleId] <Int32> [-order] <Object> [-ProgressAction <ActionPreference>] [-WhatIf]
[-Confirm] [<CommonParameters>]

DESCRIPTION​

Updates the order of custom tabs for a role via the NinjaOne v2 API. NOTE: Only tabs created on this role can be ordered. All tabs on the role must be specified.

EXAMPLES​

EXAMPLE 1​

Set-NinjaOneTabRoleOrder -roleId 10 -order @(
@{ tabId = 1; order = 1 },
@{ tabId = 2; order = 2 }
)

Sets the role tabs order for role 10.

EXAMPLE 2​

# FULL REQUEST EXAMPLE (AUTO-GENERATED) - BEGIN
PS> $body = @(
@{
tabId = 0
position = 0
}
)
PS> Set-NinjaOneTabRoleOrder -roleId 1 -order $body
# FULL REQUEST EXAMPLE (AUTO-GENERATED) - END

Full request example (auto-generated).

PARAMETERS​

-roleId​

The role Id to set tab order for.

Type: Int32
Parameter Sets: (All)
Aliases:

Required: True
Position: 1
Default value: 0
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-order​

Array payload specifying the tab ordering (CustomTabsOrderPublicApiDTO[])

Type: Object
Parameter Sets: (All)
Aliases: body

Required: True
Position: 2
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-WhatIf​

Shows what would happen if the cmdlet runs. The cmdlet is not run.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Confirm​

Prompts you for confirmation before running the cmdlet.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf

Required: False
Position: Named
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​

OUTPUTS​

Updated order data per API.​

NOTES​

https://docs.homotechsual.dev/modules/ninjaone/commandlets/Set/tab-role-order