Edit

Share via


Remove-Whiteboard

Deletes the specified whiteboard for the given user from the Microsoft Whiteboard service.

Syntax

Default (Default)

Remove-Whiteboard
    [-UserId] <Guid>
    [-WhiteboardId] <Guid>
    [-ForceAuthPrompt]
    [<CommonParameters>]

Description

Removes the specified whiteboard (owner) or a joined user removes themselves from the specified whiteboard. If the user is the owner of the whiteboard, the entire whiteboard will be deleted. If the user has joined the whiteboard but does not own it, they will be removed and the whiteboard will still be accessible by others.

Examples

EXAMPLE 1

Remove-Whiteboard -UserId 00000000-0000-0000-0000-000000000001 -WhiteboardId 00000000-0000-0000-0000-000000000002

Deletes the whiteboard.

Parameters

-ForceAuthPrompt

(Optional) Always prompt for auth. Use to ignore cached credentials.

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

-UserId

The ID of the user account to delete the whiteboard from.

Parameter properties

Type:System.Guid
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:1
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-WhiteboardId

The ID of a specific whiteboard to delete.

Parameter properties

Type:System.Guid
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:2
Mandatory:True
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.