< Back
New-MgaExchCategory
Post
NAME New-MgaExchCategory
SYNOPSIS
Creates a new category in Exchange Online using the graph api.
SYNTAX
New-MgaExchCategory [-Name] <String[]> [[-Color] {NoColorMapped | Red | Orange | Brown | Yellow | Green | Teal |
Olive | Blue | Purple | Cranberry | Steel | DarkSteel | Gray | DarkGray | Black | DarkRed | DarkOrange | DarkBrown
| DarkYellow | DarkGreen | DarkTeal | DarkOlive | DarkBlue | DarkPurple | DarkCranberry}] [-User <String>] [-Token
<AzureAccessToken>] [-WhatIf] [-Confirm] [<CommonParameters>]
DESCRIPTION
Creates a new category in Exchange Online using the graph api.
PARAMETERS
-Name <String[]>
The category name.
Required? true
Position? 1
Default value
Accept pipeline input? true (ByValue, ByPropertyName)
Accept wildcard characters? false
-Color
The color for the category.
Tab completion is available on this parameter for the list of the 25 predefined colors.
Required? false
Position? 2
Default value
Accept pipeline input? false
Accept wildcard characters? false
-User <String>
The user-account to access. Defaults to the main user connected as.
Can be any primary email name of any user the connected token has access to.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-Token <AzureAccessToken>
The token representing an established connection to the Microsoft Graph Api.
Can be created by using New-MgaAccessToken.
Can be omitted if a connection has been registered using the -Register parameter on New-MgaAccessToken.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-WhatIf [<SwitchParameter>]
If this switch is enabled, no actions are performed but informational messages will be displayed that explain
what would happen if the command were to run.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-Confirm [<SwitchParameter>]
If this switch is enabled, you will be prompted for confirmation before executing any operations that change
state.
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
OUTPUTS
MSGraph.Exchange.Category.OutlookCategory
NOTES
For addiontional information about Microsoft Graph API go to:
https://docs.microsoft.com/en-us/graph/ ... h-rest-1.0
-------------------------- EXAMPLE 1 --------------------------
PS C:\\>New-MgaExchCategory -Name "Important stuff"
Creates a category "Important stuff" in the mailbox of the user connected to through a token.
The new category will creates without color mapping.
-------------------------- EXAMPLE 2 --------------------------
PS C:\\>Get-MgaExchCategory -Name "Important stuff" -Color "Blue"
Creates a blue colored category "Important stuff" in the mailbox of the user connected to through a token.
RELATED LINKS
SYNOPSIS
Creates a new category in Exchange Online using the graph api.
SYNTAX
New-MgaExchCategory [-Name] <String[]> [[-Color] {NoColorMapped | Red | Orange | Brown | Yellow | Green | Teal |
Olive | Blue | Purple | Cranberry | Steel | DarkSteel | Gray | DarkGray | Black | DarkRed | DarkOrange | DarkBrown
| DarkYellow | DarkGreen | DarkTeal | DarkOlive | DarkBlue | DarkPurple | DarkCranberry}] [-User <String>] [-Token
<AzureAccessToken>] [-WhatIf] [-Confirm] [<CommonParameters>]
DESCRIPTION
Creates a new category in Exchange Online using the graph api.
PARAMETERS
-Name <String[]>
The category name.
Required? true
Position? 1
Default value
Accept pipeline input? true (ByValue, ByPropertyName)
Accept wildcard characters? false
-Color
The color for the category.
Tab completion is available on this parameter for the list of the 25 predefined colors.
Required? false
Position? 2
Default value
Accept pipeline input? false
Accept wildcard characters? false
-User <String>
The user-account to access. Defaults to the main user connected as.
Can be any primary email name of any user the connected token has access to.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-Token <AzureAccessToken>
The token representing an established connection to the Microsoft Graph Api.
Can be created by using New-MgaAccessToken.
Can be omitted if a connection has been registered using the -Register parameter on New-MgaAccessToken.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-WhatIf [<SwitchParameter>]
If this switch is enabled, no actions are performed but informational messages will be displayed that explain
what would happen if the command were to run.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-Confirm [<SwitchParameter>]
If this switch is enabled, you will be prompted for confirmation before executing any operations that change
state.
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
OUTPUTS
MSGraph.Exchange.Category.OutlookCategory
NOTES
For addiontional information about Microsoft Graph API go to:
https://docs.microsoft.com/en-us/graph/ ... h-rest-1.0
-------------------------- EXAMPLE 1 --------------------------
PS C:\\>New-MgaExchCategory -Name "Important stuff"
Creates a category "Important stuff" in the mailbox of the user connected to through a token.
The new category will creates without color mapping.
-------------------------- EXAMPLE 2 --------------------------
PS C:\\>Get-MgaExchCategory -Name "Important stuff" -Color "Blue"
Creates a blue colored category "Important stuff" in the mailbox of the user connected to through a token.
RELATED LINKS