New-MgBetaDeviceManagementVirtualEndpointBulkAction
Create a new cloudPcBulkAction object.
Syntax
New-MgBetaDeviceManagementVirtualEndpointBulkAction
[-ResponseHeadersVariable <String>]
[-ActionSummary <IMicrosoftGraphCloudPcBulkActionSummary>]
[-AdditionalProperties <Hashtable>]
[-CloudPcIds <String[]>]
[-CreatedDateTime <DateTime>]
[-DisplayName <String>]
[-Id <String>]
[-InitiatedByUserPrincipalName <String>]
[-ScheduledDuringMaintenanceWindow]
[-Status <String>]
[-Headers <IDictionary>]
[-ProgressAction <ActionPreference>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-MgBetaDeviceManagementVirtualEndpointBulkAction
-BodyParameter <IMicrosoftGraphCloudPcBulkAction>
[-ResponseHeadersVariable <String>]
[-Headers <IDictionary>]
[-ProgressAction <ActionPreference>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Create a new cloudPcBulkAction object.
Permissions
Permission type | Least privileged permissions | Higher privileged permissions |
---|---|---|
Delegated (work or school account) | CloudPC.ReadWrite.All | Not available. |
Delegated (personal Microsoft account) | Not supported. | Not supported. |
Application | CloudPC.ReadWrite.All | Not available. |
Examples
Example 1: Code snippet
Import-Module Microsoft.Graph.Beta.DeviceManagement.Administration
$params = @{
"@odata.type" = "#microsoft.graph.cloudPcBulkAction"
displayName = "Bulk Power Off by Andy"
cloudPcIds = @(
"d6e0b8ee-8836-4b8d-b038-6130a97a3a9d"
"85994912-197b-4927-b569-447bd81350ec"
)
scheduledDuringMaintenanceWindow = $true
}
New-MgBetaDeviceManagementVirtualEndpointBulkAction -BodyParameter $params
This example shows how to use the New-MgBetaDeviceManagementVirtualEndpointBulkAction Cmdlet.
Parameters
-ActionSummary
cloudPcBulkActionSummary To construct, see NOTES section for ACTIONSUMMARY properties and create a hash table.
Type: | IMicrosoftGraphCloudPcBulkActionSummary |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AdditionalProperties
Additional Parameters
Type: | Hashtable |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-BodyParameter
cloudPcBulkAction To construct, see NOTES section for BODYPARAMETER properties and create a hash table.
Type: | IMicrosoftGraphCloudPcBulkAction |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-CloudPcIds
.
Type: | String[] |
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 |
-CreatedDateTime
The date and time when the bulk action 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, 2014 is 2014-01-01T00:00:00Z.
Type: | DateTime |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisplayName
Name of the bulk action.
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 |
-InitiatedByUserPrincipalName
Indicates the user principal name (UPN) of the user who initiated this bulk action. Read-only.
Type: | String |
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 |
-ScheduledDuringMaintenanceWindow
Indicates whether the bulk action is scheduled according to the maintenance window. When true, the bulk action uses the maintenance window to schedule the action; false means that the bulk action doesn't use the maintenance window. The default value is false.
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Status
cloudPcBulkActionStatus
Type: | String |
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.IMicrosoftGraphCloudPcBulkAction
System.Collections.IDictionary
Outputs
Microsoft.Graph.Beta.PowerShell.Models.IMicrosoftGraphCloudPcBulkAction
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.
ACTIONSUMMARY <IMicrosoftGraphCloudPcBulkActionSummary>
: cloudPcBulkActionSummary
[(Any) <Object>]
: This indicates any property can be added to this object.[FailedCount <Int32?>]
: The number of Cloud PCs where the action failed.[InProgressCount <Int32?>]
: The number of Cloud PCs where the action is in progress.[NotSupportedCount <Int32?>]
: The number of Cloud PCs where the action isn't supported.[PendingCount <Int32?>]
: The number of Cloud PCs where the action is pending.[SuccessfulCount <Int32?>]
: The number of Cloud PCs where the action is successful.
BODYPARAMETER <IMicrosoftGraphCloudPcBulkAction>
: cloudPcBulkAction
[(Any) <Object>]
: This indicates any property can be added to this object.[Id <String>]
: The unique identifier for an entity. Read-only.[ActionSummary <IMicrosoftGraphCloudPcBulkActionSummary>]
: cloudPcBulkActionSummary[(Any) <Object>]
: This indicates any property can be added to this object.[FailedCount <Int32?>]
: The number of Cloud PCs where the action failed.[InProgressCount <Int32?>]
: The number of Cloud PCs where the action is in progress.[NotSupportedCount <Int32?>]
: The number of Cloud PCs where the action isn't supported.[PendingCount <Int32?>]
: The number of Cloud PCs where the action is pending.[SuccessfulCount <Int32?>]
: The number of Cloud PCs where the action is successful.
[CloudPcIds <String-
[]>]
:[CreatedDateTime <DateTime?>]
: The date and time when the bulk action 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, 2014 is 2014-01-01T00:00:00Z.[DisplayName <String>]
: Name of the bulk action.[InitiatedByUserPrincipalName <String>]
: Indicates the user principal name (UPN) of the user who initiated this bulk action. Read-only.[ScheduledDuringMaintenanceWindow <Boolean?>]
: Indicates whether the bulk action is scheduled according to the maintenance window. When true, the bulk action uses the maintenance window to schedule the action; false means that the bulk action doesn't use the maintenance window. The default value is false.[Status <String>]
: cloudPcBulkActionStatus