Prompts you for confirmation before running the cmdlet.
Parameter properties
Type:
System.Management.Automation.SwitchParameter
Supports wildcards:
False
DontShow:
False
Aliases:
cf
Parameter sets
(All)
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
-Content
The prompt text or content captured for this insight.
Supports $filter (eq) and $orderby.
Parameter properties
Type:
System.String
Supports wildcards:
False
DontShow:
False
Parameter sets
UpdateViaIdentityExpanded
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
UpdateExpanded
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
-CreatedDateTime
The date and time when the insight was created.
The timestamp type represents date and time information using ISO 8601 format and is always in UTC.
For example, midnight UTC on Jan 1, 2024, is 2024-01-01T00:00:00Z.
Supports $filter (eq) and $orderby.
Parameter properties
Type:
System.DateTime
Supports wildcards:
False
DontShow:
False
Parameter sets
UpdateViaIdentityExpanded
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
UpdateExpanded
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
-DestinationUrl
The destination URL associated with this insight.
Supports $filter (eq) and $orderby.
Parameter properties
Type:
System.String
Supports wildcards:
False
DontShow:
False
Parameter sets
UpdateViaIdentityExpanded
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
UpdateExpanded
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
-EventId
The unique identifier for the event.
Supports $filter (eq) and $orderby.
Parameter properties
Type:
System.String
Supports wildcards:
False
DontShow:
False
Parameter sets
UpdateViaIdentityExpanded
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
UpdateExpanded
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
-EventType
The event type that classifies the insight event.
Supports $filter (eq) and $orderby.
Parameter properties
Type:
System.String
Supports wildcards:
False
DontShow:
False
Parameter sets
UpdateViaIdentityExpanded
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
UpdateExpanded
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
-GenerativeAiInsightTransactionId
The unique identifier of generativeAIInsight
Parameter properties
Type:
System.String
Supports wildcards:
False
DontShow:
False
Parameter sets
UpdateExpanded
Position:
Named
Mandatory:
True
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
Update
Position:
Named
Mandatory:
True
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
-Headers
Optional headers that will be added to the request.
Parameter properties
Type:
System.Collections.IDictionary
Supports wildcards:
False
DontShow:
False
Parameter sets
(All)
Position:
Named
Mandatory:
False
Value from pipeline:
True
Value from pipeline by property name:
False
Value from remaining arguments:
False
-HttpPipelineAppend
SendAsync Pipeline Steps to be appended to the front of the pipeline
The MCP client name when the activity is related to MCP interactions.
Supports $filter (eq) and $orderby.
Parameter properties
Type:
System.String
Supports wildcards:
False
DontShow:
False
Parameter sets
UpdateViaIdentityExpanded
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
UpdateExpanded
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
-McpServerName
The MCP server name when the activity is related to MCP interactions.
Supports $filter (eq) and $orderby.
Parameter properties
Type:
System.String
Supports wildcards:
False
DontShow:
False
Parameter sets
UpdateViaIdentityExpanded
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
UpdateExpanded
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
-Proxy
The URI for the proxy server to use
Parameter properties
Type:
System.Uri
Supports wildcards:
False
DontShow:
False
Parameter sets
(All)
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
-ProxyCredential
Credentials for a proxy server to use for the remote call
Parameter properties
Type:
System.Management.Automation.PSCredential
Supports wildcards:
False
DontShow:
False
Parameter sets
(All)
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
-ProxyUseDefaultCredentials
Use the default credentials for the proxy
Parameter properties
Type:
System.Management.Automation.SwitchParameter
Default value:
False
Supports wildcards:
False
DontShow:
False
Parameter sets
(All)
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
-ResponseHeadersVariable
Optional Response Headers Variable.
Parameter properties
Type:
System.String
Supports wildcards:
False
DontShow:
False
Aliases:
RHV
Parameter sets
(All)
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
-SessionId
The session identifier used to correlate related events.
Supports $filter (eq) and $orderby.
Parameter properties
Type:
System.String
Supports wildcards:
False
DontShow:
False
Parameter sets
UpdateViaIdentityExpanded
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
UpdateExpanded
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
-Subactivity
A finer-grained classification of activity, such as chat-interaction, tools/call, or data-analysis.
Supports $filter (eq) and $orderby.
Parameter properties
Type:
System.String
Supports wildcards:
False
DontShow:
False
Parameter sets
UpdateViaIdentityExpanded
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
UpdateExpanded
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
-TransactionId
A unique identifier assigned to a specific transaction or operation.
Key.
Supports $filter (eq) and $orderby.
Parameter properties
Type:
System.String
Supports wildcards:
False
DontShow:
False
Parameter sets
UpdateViaIdentityExpanded
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
UpdateExpanded
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
-UserPrincipalName
The UPN of the user associated with this insight.
Supports $filter (eq) and $orderby.
Parameter properties
Type:
System.String
Supports wildcards:
False
DontShow:
False
Parameter sets
UpdateViaIdentityExpanded
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
UpdateExpanded
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
-WhatIf
Runs the command in a mode that only reports what would happen without performing the actions.
Parameter properties
Type:
System.Management.Automation.SwitchParameter
Supports wildcards:
False
DontShow:
False
Aliases:
wi
Parameter sets
(All)
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
CommonParameters
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable,
-InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable,
-ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see
about_CommonParameters.
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 <IMicrosoftGraphNetworkaccessGenerativeAiInsight>: generativeAIInsight
[(Any) <Object>]: This indicates any property can be added to this object.
[Activity <String>]: applicationActivity
[Content <String>]: The prompt text or content captured for this insight.
Supports $filter (eq) and $orderby.
[CreatedDateTime <DateTime?>]: The date and time when the insight was created.
The timestamp type represents date and time information using ISO 8601 format and is always in UTC.
For example, midnight UTC on Jan 1, 2024, is 2024-01-01T00:00:00Z.
Supports $filter (eq) and $orderby.
[DestinationUrl <String>]: The destination URL associated with this insight.
Supports $filter (eq) and $orderby.
[EventId <String>]: The unique identifier for the event.
Supports $filter (eq) and $orderby.
[EventType <String>]: The event type that classifies the insight event.
Supports $filter (eq) and $orderby.
[McpClientName <String>]: The MCP client name when the activity is related to MCP interactions.
Supports $filter (eq) and $orderby.
[McpServerName <String>]: The MCP server name when the activity is related to MCP interactions.
Supports $filter (eq) and $orderby.
[SessionId <String>]: The session identifier used to correlate related events.
Supports $filter (eq) and $orderby.
[Subactivity <String>]: A finer-grained classification of activity, such as chat-interaction, tools/call, or data-analysis.
Supports $filter (eq) and $orderby.
[TransactionId <String>]: A unique identifier assigned to a specific transaction or operation.
Key.
Supports $filter (eq) and $orderby.
[UserPrincipalName <String>]: The UPN of the user associated with this insight.
Supports $filter (eq) and $orderby.
INPUTOBJECT <INetworkAccessIdentity>: Identity Parameter
[ActivityPivotDateTime <DateTime?>]: Usage: activityPivotDateTime={activityPivotDateTime}
[AggregatedBy <String>]: Usage: aggregatedBy='{aggregatedBy}'
[AlertId <String>]: The unique identifier of alert
[BranchSiteId <String>]: The unique identifier of branchSite
[CloudFirewallPolicyId <String>]: The unique identifier of cloudFirewallPolicy
[ConditionalAccessPolicyId <String>]: The unique identifier of conditionalAccessPolicy
[ConnectionId <String>]: The unique identifier of connection
[ConnectivityConfigurationLinkId <String>]: The unique identifier of connectivityConfigurationLink
[DeviceLinkId <String>]: The unique identifier of deviceLink
[DiscoveryPivotDateTime <DateTime?>]: Usage: discoveryPivotDateTime={discoveryPivotDateTime}
[EndDateTime <DateTime?>]: Usage: endDateTime={endDateTime}
[ExternalCertificateAuthorityCertificateId <String>]: The unique identifier of externalCertificateAuthorityCertificate
[FilteringPolicyId <String>]: The unique identifier of filteringPolicy
[FilteringProfileId <String>]: The unique identifier of filteringProfile
[ForwardingPolicyId <String>]: The unique identifier of forwardingPolicy
[ForwardingProfileId <String>]: The unique identifier of forwardingProfile
[GenerativeAiInsightTransactionId <String>]: The unique identifier of generativeAIInsight
[NetworkAccessTrafficTransactionId <String>]: The unique identifier of networkAccessTraffic
[PolicyLinkId <String>]: The unique identifier of policyLink
[PolicyRuleId <String>]: The unique identifier of policyRule
[RemoteNetworkHealthEventId <String>]: The unique identifier of remoteNetworkHealthEvent
[RemoteNetworkId <String>]: The unique identifier of remoteNetwork
[StartDateTime <DateTime?>]: Usage: startDateTime={startDateTime}
[ThreatIntelligencePolicyId <String>]: The unique identifier of threatIntelligencePolicy
[TlsInspectionPolicyId <String>]: The unique identifier of tlsInspectionPolicy
[Url <String>]: Usage: url='{url}'