New-MgBetaComplianceEdiscoveryCaseTag

Module:

Microsoft.Graph.Beta.Compliance

Create a new tag for the specified case. The tags are used in review sets while reviewing content.

Syntax

New-MgBetaComplianceEdiscoveryCaseTag
   -CaseId <String>
   [-ResponseHeadersVariable <String>]
   [-AdditionalProperties <Hashtable>]
   [-ChildSelectability <String>]
   [-ChildTags <IMicrosoftGraphEdiscoveryTag[]>]
   [-CreatedBy <IMicrosoftGraphIdentitySet>]
   [-Description <String>]
   [-DisplayName <String>]
   [-Id <String>]
   [-LastModifiedDateTime <DateTime>]
   [-Parent <IMicrosoftGraphEdiscoveryTag>]
   [-Headers <IDictionary>]
   [-ProgressAction <ActionPreference>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-MgBetaComplianceEdiscoveryCaseTag
   -CaseId <String>
   -BodyParameter <IMicrosoftGraphEdiscoveryTag>
   [-ResponseHeadersVariable <String>]
   [-Headers <IDictionary>]
   [-ProgressAction <ActionPreference>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-MgBetaComplianceEdiscoveryCaseTag
   -InputObject <IComplianceIdentity>
   [-ResponseHeadersVariable <String>]
   [-AdditionalProperties <Hashtable>]
   [-ChildSelectability <String>]
   [-ChildTags <IMicrosoftGraphEdiscoveryTag[]>]
   [-CreatedBy <IMicrosoftGraphIdentitySet>]
   [-Description <String>]
   [-DisplayName <String>]
   [-Id <String>]
   [-LastModifiedDateTime <DateTime>]
   [-Parent <IMicrosoftGraphEdiscoveryTag>]
   [-Headers <IDictionary>]
   [-ProgressAction <ActionPreference>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-MgBetaComplianceEdiscoveryCaseTag
   -InputObject <IComplianceIdentity>
   -BodyParameter <IMicrosoftGraphEdiscoveryTag>
   [-ResponseHeadersVariable <String>]
   [-Headers <IDictionary>]
   [-ProgressAction <ActionPreference>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Create a new tag for the specified case. The tags are used in review sets while reviewing content.

Examples

Example 1: Code snippet

Import-Module Microsoft.Graph.Beta.Compliance

$params = @{
	displayName = "Privileged"
	description = "The document is privileged"
	"parent@odata.bind" = "https://graph.microsoft.com/beta/compliance/ediscovery/cases/47746044-fd0b-4a30-acfc-5272b691ba5b/tags/98fdad78bbce4519b75474bc150575c3"
}

New-MgBetaComplianceEdiscoveryCaseTag -CaseId $caseId -BodyParameter $params

This example shows how to use the New-MgBetaComplianceEdiscoveryCaseTag Cmdlet.

Parameters

-AdditionalProperties

Additional Parameters

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

-BodyParameter

tag To construct, see NOTES section for BODYPARAMETER properties and create a hash table.

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

-CaseId

The unique identifier of case

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

-ChildSelectability

childSelectability

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

-ChildTags

Returns the tags that are a child of a tag. To construct, see NOTES section for CHILDTAGS properties and create a hash table.

Type:	IMicrosoftGraphEdiscoveryTag[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

Prompts you for confirmation before running the cmdlet.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-CreatedBy

identitySet To construct, see NOTES section for CREATEDBY properties and create a hash table.

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

-Description

The description for the tag.

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

-DisplayName

Display name of the tag.

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

-Headers

Optional headers that will be added to the request.

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

-Id

The unique identifier for an entity. Read-only.

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

-InputObject

Identity Parameter To construct, see NOTES section for INPUTOBJECT properties and create a hash table.

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

-LastModifiedDateTime

The date and time the tag was last modified.

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

-Parent

tag To construct, see NOTES section for PARENT properties and create a hash table.

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

-ProgressAction

{{ Fill ProgressAction Description }}

Type:	ActionPreference
Aliases:	proga
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ResponseHeadersVariable

Optional Response Headers Variable.

Type:	String
Aliases:	RHV
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

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

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Inputs

Microsoft.Graph.Beta.PowerShell.Models.IComplianceIdentity

Microsoft.Graph.Beta.PowerShell.Models.IMicrosoftGraphEdiscoveryTag

System.Collections.IDictionary

Outputs

Microsoft.Graph.Beta.PowerShell.Models.IMicrosoftGraphEdiscoveryTag

Notes

COMPLEX PARAMETER PROPERTIES

To create the parameters described below, construct a hash table containing the appropriate properties. For information on hash tables, run Get-Help about_Hash_Tables.

BODYPARAMETER <IMicrosoftGraphEdiscoveryTag>: tag

• [(Any) <Object>]: This indicates any property can be added to this object.
• [Id <String>]: The unique identifier for an entity. Read-only.
• [ChildSelectability <String>]: childSelectability
• [ChildTags <IMicrosoftGraphEdiscoveryTag- []>]: Returns the tags that are a child of a tag.
• [CreatedBy <IMicrosoftGraphIdentitySet>]: identitySet
  • [(Any) <Object>]: This indicates any property can be added to this object.
  • [Application <IMicrosoftGraphIdentity>]: identity
    • [(Any) <Object>]: This indicates any property can be added to this object.
    • [DisplayName <String>]: The display name of the identity. The display name might not always be available or up to date. For example, if a user changes their display name the API might show the new value in a future response, but the items associated with the user won't show up as having changed when using delta.
    • [Id <String>]: Unique identifier for the identity. When the unique identifier is unavailable, the displayName property is provided for the identity, but the id property isn't included in the response.
  • [Device <IMicrosoftGraphIdentity>]: identity
  • [User <IMicrosoftGraphIdentity>]: identity
• [Description <String>]: The description for the tag.
• [DisplayName <String>]: Display name of the tag.
• [LastModifiedDateTime <DateTime?>]: The date and time the tag was last modified.
• [Parent <IMicrosoftGraphEdiscoveryTag>]: tag

CHILDTAGS <IMicrosoftGraphEdiscoveryTag- []>: Returns the tags that are a child of a tag.

• [Id <String>]: The unique identifier for an entity. Read-only.
• [ChildSelectability <String>]: childSelectability
• [ChildTags <IMicrosoftGraphEdiscoveryTag- []>]: Returns the tags that are a child of a tag.
• [CreatedBy <IMicrosoftGraphIdentitySet>]: identitySet
  • [(Any) <Object>]: This indicates any property can be added to this object.
  • [Application <IMicrosoftGraphIdentity>]: identity
    • [(Any) <Object>]: This indicates any property can be added to this object.
    • [DisplayName <String>]: The display name of the identity. The display name might not always be available or up to date. For example, if a user changes their display name the API might show the new value in a future response, but the items associated with the user won't show up as having changed when using delta.
    • [Id <String>]: Unique identifier for the identity. When the unique identifier is unavailable, the displayName property is provided for the identity, but the id property isn't included in the response.
  • [Device <IMicrosoftGraphIdentity>]: identity
  • [User <IMicrosoftGraphIdentity>]: identity
• [Description <String>]: The description for the tag.
• [DisplayName <String>]: Display name of the tag.
• [LastModifiedDateTime <DateTime?>]: The date and time the tag was last modified.
• [Parent <IMicrosoftGraphEdiscoveryTag>]: tag

CREATEDBY <IMicrosoftGraphIdentitySet>: identitySet

• [(Any) <Object>]: This indicates any property can be added to this object.
• [Application <IMicrosoftGraphIdentity>]: identity
  • [(Any) <Object>]: This indicates any property can be added to this object.
  • [DisplayName <String>]: The display name of the identity. The display name might not always be available or up to date. For example, if a user changes their display name the API might show the new value in a future response, but the items associated with the user won't show up as having changed when using delta.
  • [Id <String>]: Unique identifier for the identity. When the unique identifier is unavailable, the displayName property is provided for the identity, but the id property isn't included in the response.
• [Device <IMicrosoftGraphIdentity>]: identity
• [User <IMicrosoftGraphIdentity>]: identity

INPUTOBJECT <IComplianceIdentity>: Identity Parameter

• [AuthoredNoteId <String>]: The unique identifier of authoredNote
• [CaseId <String>]: The unique identifier of case
• [CaseOperationId <String>]: The unique identifier of caseOperation
• [CustodianId <String>]: The unique identifier of custodian
• [DataSourceId <String>]: The unique identifier of dataSource
• [LegalHoldId <String>]: The unique identifier of legalHold
• [NoncustodialDataSourceId <String>]: The unique identifier of noncustodialDataSource
• [ReviewSetId <String>]: The unique identifier of reviewSet
• [ReviewSetQueryId <String>]: The unique identifier of reviewSetQuery
• [SiteSourceId <String>]: The unique identifier of siteSource
• [SourceCollectionId <String>]: The unique identifier of sourceCollection
• [SubjectRightsRequestId <String>]: The unique identifier of subjectRightsRequest
• [TagId <String>]: The unique identifier of tag
• [TagId1 <String>]: The unique identifier of tag
• [UnifiedGroupSourceId <String>]: The unique identifier of unifiedGroupSource
• [UserId <String>]: The unique identifier of user
• [UserSourceId <String>]: The unique identifier of userSource

PARENT <IMicrosoftGraphEdiscoveryTag>: tag

• [(Any) <Object>]: This indicates any property can be added to this object.
• [Id <String>]: The unique identifier for an entity. Read-only.
• [ChildSelectability <String>]: childSelectability
• [ChildTags <IMicrosoftGraphEdiscoveryTag- []>]: Returns the tags that are a child of a tag.
• [CreatedBy <IMicrosoftGraphIdentitySet>]: identitySet
  • [(Any) <Object>]: This indicates any property can be added to this object.
  • [Application <IMicrosoftGraphIdentity>]: identity
    • [(Any) <Object>]: This indicates any property can be added to this object.
    • [DisplayName <String>]: The display name of the identity. The display name might not always be available or up to date. For example, if a user changes their display name the API might show the new value in a future response, but the items associated with the user won't show up as having changed when using delta.
    • [Id <String>]: Unique identifier for the identity. When the unique identifier is unavailable, the displayName property is provided for the identity, but the id property isn't included in the response.
  • [Device <IMicrosoftGraphIdentity>]: identity
  • [User <IMicrosoftGraphIdentity>]: identity
• [Description <String>]: The description for the tag.
• [DisplayName <String>]: Display name of the tag.
• [LastModifiedDateTime <DateTime?>]: The date and time the tag was last modified.
• [Parent <IMicrosoftGraphEdiscoveryTag>]: tag

Related Links

• https://learn.microsoft.com/powershell/module/microsoft.graph.beta.compliance/new-mgbetacomplianceediscoverycasetag
• https://learn.microsoft.com/graph/api/ediscovery-case-post-tags?view=graph-rest-1.0