New-MgBetaSecurityCopilotWorkspace

Module:

Microsoft.Graph.Beta.Security Module

Create new navigation property to workspaces for security

Syntax

CreateExpanded (Default)

New-MgBetaSecurityCopilotWorkspace
    [-ResponseHeadersVariable <string>]
    [-AdditionalProperties <hashtable>]
    [-DisplayName <string>]
    [-Id <string>]
    [-Plugins <IMicrosoftGraphSecurityCopilotPlugin[]>]
    [-Sessions <IMicrosoftGraphSecurityCopilotSession[]>]
    [-Break]
    [-Headers <IDictionary>]
    [-HttpPipelineAppend <SendAsyncStep[]>]
    [-HttpPipelinePrepend <SendAsyncStep[]>]
    [-Proxy <uri>]
    [-ProxyCredential <pscredential>]
    [-ProxyUseDefaultCredentials]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Create

New-MgBetaSecurityCopilotWorkspace
    -BodyParameter <IMicrosoftGraphSecurityCopilotWorkspace>
    [-ResponseHeadersVariable <string>]
    [-Break]
    [-Headers <IDictionary>]
    [-HttpPipelineAppend <SendAsyncStep[]>]
    [-HttpPipelinePrepend <SendAsyncStep[]>]
    [-Proxy <uri>]
    [-ProxyCredential <pscredential>]
    [-ProxyUseDefaultCredentials]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Parameters

-AdditionalProperties

Additional Parameters

Parameter properties

Type:	System.Collections.Hashtable
Supports wildcards:	False
DontShow:	False

Parameter sets

CreateExpanded

Position:	Named
Mandatory:	False
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

-BodyParameter

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

Parameter properties

Type:	Microsoft.Graph.Beta.PowerShell.Models.IMicrosoftGraphSecurityCopilotWorkspace
Supports wildcards:	False
DontShow:	False

Parameter sets

Create

Position:	Named
Mandatory:	True
Value from pipeline:	True
Value from pipeline by property name:	False
Value from remaining arguments:	False

-Break

Wait for .NET debugger to attach

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

-Confirm

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

-DisplayName

Name of the Security Copilot workspace.

Parameter properties

Type:	System.String
Supports wildcards:	False
DontShow:	False

Parameter sets

CreateExpanded

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

Parameter properties

Type:	Microsoft.Graph.Beta.PowerShell.Runtime.SendAsyncStep[]
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

-HttpPipelinePrepend

SendAsync Pipeline Steps to be prepended to the front of the pipeline

Parameter properties

Type:	Microsoft.Graph.Beta.PowerShell.Runtime.SendAsyncStep[]
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

-Id

The unique identifier for an entity. Read-only.

Parameter properties

Type:	System.String
Supports wildcards:	False
DontShow:	False

Parameter sets

CreateExpanded

Position:	Named
Mandatory:	False
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

-Plugins

Represents plugins in Security Copilot. To construct, see NOTES section for PLUGINS properties and create a hash table.

Parameter properties

Type:	Microsoft.Graph.Beta.PowerShell.Models.IMicrosoftGraphSecurityCopilotPlugin[]
Supports wildcards:	False
DontShow:	False

Parameter sets

CreateExpanded

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

-Sessions

Represents sessions in Security Copilot. To construct, see NOTES section for SESSIONS properties and create a hash table.

Parameter properties

Type:	Microsoft.Graph.Beta.PowerShell.Models.IMicrosoftGraphSecurityCopilotSession[]
Supports wildcards:	False
DontShow:	False

Parameter sets

CreateExpanded

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.

Inputs

Microsoft.Graph.Beta.PowerShell.Models.IMicrosoftGraphSecurityCopilotWorkspace

{{ Fill in the Description }}

System.Collections.IDictionary

{{ Fill in the Description }}

Outputs

Microsoft.Graph.Beta.PowerShell.Models.IMicrosoftGraphSecurityCopilotWorkspace

{{ Fill in the Description }}

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 <IMicrosoftGraphSecurityCopilotWorkspace>: workspace [(Any) <Object>]: This indicates any property can be added to this object. [Id <String>]: The unique identifier for an entity. Read-only. [DisplayName <String>]: Name of the Security Copilot workspace. [Plugins <IMicrosoftGraphSecurityCopilotPlugin[]>]: Represents plugins in Security Copilot. [Authorization <IMicrosoftGraphSecurityCopilotPluginAuth>]: pluginAuth [(Any) <Object>]: This indicates any property can be added to this object. [AuthType <String>]: pluginAuthTypes [CatalogScope <String>]: pluginCatalogScope [Category <String>]: pluginCategory [Description <String>]: Brief description of the plugin. [DisplayName <String>]: Display name of the plugin. Supports $filter (eq). [IsEnabled <Boolean?>]: Displays whether the plugin is enabled for use within the catalogScope. Supports $filter (eq). [Name <String>]: Represents the name of the plugin. Primary key. Supports $filter (eq, contains). [PreviewState <String>]: pluginPreviewStates [Settings <IMicrosoftGraphSecurityCopilotPluginSetting[]>]: Settings for the plugin. [AcceptableValues <String[]>]: Acceptable values for plugin type [DefaultValue <String>]: Default value available for the plugin if not configured [Description <String>]: Description of the value requested [DisplayType <String>]: pluginSettingDisplayType [HintText <String>]: Hint for the plugin [IsRequired <Boolean?>]: Setting whether the value is required [Label <String>]: Label for the setting [Name <String>]: Name of the setting [SettingValue <String>]: pluginSettingType [Value <String>]: Value [SupportedAuthTypes <String>]: pluginAuthTypes [Sessions <IMicrosoftGraphSecurityCopilotSession[]>]: Represents sessions in Security Copilot. [Id <String>]: The unique identifier for an entity. Read-only. [CreatedDateTime <DateTime?>]: Created time of the session (UTC). [DisplayName <String>]: Display name for the session. [LastModifiedDateTime <DateTime?>]: Last modified time of the session (UTC). Updated when displayName changes. [Prompts <IMicrosoftGraphSecurityCopilotPrompt[]>]: The collection of prompts in the session. [Id <String>]: The unique identifier for an entity. Read-only. [Content <String>]: Input content to the prompt. [CreatedDateTime <DateTime?>]: Created time. [Evaluations <IMicrosoftGraphSecurityCopilotEvaluation[]>]: Collection of evaluations [Id <String>]: The unique identifier for an entity. Read-only. [CompletedDateTime <DateTime?>]: Evaluation completion time. [CreatedDateTime <DateTime?>]: Evaluation created time. [ExecutionCount <Int64?>]: Evaluation execution count. [IsCancelled <Boolean?>]: Evaluation cancellation status. [LastModifiedDateTime <DateTime?>]: Evaluation modified time. [Result <IMicrosoftGraphSecurityCopilotEvaluationResult>]: evaluationResult [(Any) <Object>]: This indicates any property can be added to this object. [Content <String>]: The final content. [PreviewState <String>]: skillPreviewState [Type <String>]: evaluationResultType [RunStartDateTime <DateTime?>]: Evaluation Run start time. [State <String>]: evaluationState [LastModifiedDateTime <DateTime?>]: Last modified time. [SkillInputDescriptors <IMicrosoftGraphSecurityCopilotSkillInputDescriptor[]>]: Skill Input descriptor. [Description <String>]: Unsupported. [Name <String>]: Unsupported. [Type <IMicrosoftGraphSecurityCopilotSkillTypeDescriptor>]: skillTypeDescriptor [(Any) <Object>]: This indicates any property can be added to this object. [Name <String>]: Unsupported. [DefaultValue <String>]: Unsupported. [IsRequired <Boolean?>]: Unsupported. [PlaceholderValue <String>]: Unsupported. [SkillName <String>]: Skill name. [Type <String>]: promptType

PLUGINS <IMicrosoftGraphSecurityCopilotPlugin[]>: Represents plugins in Security Copilot. [Authorization <IMicrosoftGraphSecurityCopilotPluginAuth>]: pluginAuth [(Any) <Object>]: This indicates any property can be added to this object. [AuthType <String>]: pluginAuthTypes [CatalogScope <String>]: pluginCatalogScope [Category <String>]: pluginCategory [Description <String>]: Brief description of the plugin. [DisplayName <String>]: Display name of the plugin. Supports $filter (eq). [IsEnabled <Boolean?>]: Displays whether the plugin is enabled for use within the catalogScope. Supports $filter (eq). [Name <String>]: Represents the name of the plugin. Primary key. Supports $filter (eq, contains). [PreviewState <String>]: pluginPreviewStates [Settings <IMicrosoftGraphSecurityCopilotPluginSetting[]>]: Settings for the plugin. [AcceptableValues <String[]>]: Acceptable values for plugin type [DefaultValue <String>]: Default value available for the plugin if not configured [Description <String>]: Description of the value requested [DisplayType <String>]: pluginSettingDisplayType [HintText <String>]: Hint for the plugin [IsRequired <Boolean?>]: Setting whether the value is required [Label <String>]: Label for the setting [Name <String>]: Name of the setting [SettingValue <String>]: pluginSettingType [Value <String>]: Value [SupportedAuthTypes <String>]: pluginAuthTypes

SESSIONS <IMicrosoftGraphSecurityCopilotSession[]>: Represents sessions in Security Copilot. [Id <String>]: The unique identifier for an entity. Read-only. [CreatedDateTime <DateTime?>]: Created time of the session (UTC). [DisplayName <String>]: Display name for the session. [LastModifiedDateTime <DateTime?>]: Last modified time of the session (UTC). Updated when displayName changes. [Prompts <IMicrosoftGraphSecurityCopilotPrompt[]>]: The collection of prompts in the session. [Id <String>]: The unique identifier for an entity. Read-only. [Content <String>]: Input content to the prompt. [CreatedDateTime <DateTime?>]: Created time. [Evaluations <IMicrosoftGraphSecurityCopilotEvaluation[]>]: Collection of evaluations [Id <String>]: The unique identifier for an entity. Read-only. [CompletedDateTime <DateTime?>]: Evaluation completion time. [CreatedDateTime <DateTime?>]: Evaluation created time. [ExecutionCount <Int64?>]: Evaluation execution count. [IsCancelled <Boolean?>]: Evaluation cancellation status. [LastModifiedDateTime <DateTime?>]: Evaluation modified time. [Result <IMicrosoftGraphSecurityCopilotEvaluationResult>]: evaluationResult [(Any) <Object>]: This indicates any property can be added to this object. [Content <String>]: The final content. [PreviewState <String>]: skillPreviewState [Type <String>]: evaluationResultType [RunStartDateTime <DateTime?>]: Evaluation Run start time. [State <String>]: evaluationState [LastModifiedDateTime <DateTime?>]: Last modified time. [SkillInputDescriptors <IMicrosoftGraphSecurityCopilotSkillInputDescriptor[]>]: Skill Input descriptor. [Description <String>]: Unsupported. [Name <String>]: Unsupported. [Type <IMicrosoftGraphSecurityCopilotSkillTypeDescriptor>]: skillTypeDescriptor [(Any) <Object>]: This indicates any property can be added to this object. [Name <String>]: Unsupported. [DefaultValue <String>]: Unsupported. [IsRequired <Boolean?>]: Unsupported. [PlaceholderValue <String>]: Unsupported. [SkillName <String>]: Skill name. [Type <String>]: promptType

Related Links

• New-MgBetaSecurityCopilotWorkspace