Start-BTCutover

NAME Start-BTCutover



SYNOPSIS

Start Cutover operations for Power365 Users.





SYNTAX

Start-BTCutover -User <object> [-Project <object>] [-Session <Session>] [<CommonParameters>]



Start-BTCutover -Wave <object> [-Project <object>] [-Session <Session>] [<CommonParameters>]



Start-BTCutover [-InputObject] <object> [-Project <object>] [-Session <Session>] [<CommonParameters>]





DESCRIPTION

Start-BTCutover -User starts a Cutover operation for a User.



Start-BTCutover -Wave starts a Cutover operation for a Wave.



Start-BTCutover -InputObject starts a Cutover operation for a User or Wave.



The ApiKey role must be 'Writer' to run the Start-BTCutover cmdlet.





PARAMETERS

-User <object>

User identity: UserId, Uid, SamAccountName, Mail, UserPrincipalName, DisplayName, or User object.



Required? true

Position? named

Default value

Accept pipeline input? false

Accept wildcard characters? false



-Wave <object>

Wave identity: WaveId, WaveName, or Wave object.



Required? true

Position? named

Default value

Accept pipeline input? false

Accept wildcard characters? false



-InputObject <object>

The User or Wave object.



Required? true

Position? 0

Default value

Accept pipeline input? true (ByValue)

Accept wildcard characters? false



-Project <object>

Limit scope to this Project, specified by ProjectId, ProjectName, or Project object. Defaults to the Session's

default Project, if any.



Required? false

Position? named

Default value System.Object

Accept pipeline input? false

Accept wildcard characters? false



-Session <Session>

The Power365 Session in which to run the cmdlet. Defaults to the most recently used Session.



Required? false

Position? named

Default value

Accept pipeline input? false

Accept wildcard characters? false



<CommonParameters>

This cmdlet supports the common parameters: Verbose, Debug,

ErrorAction, ErrorVariable, WarningAction, WarningVariable,

OutBuffer, PipelineVariable, and OutVariable. For more information, see

about_CommonParameters (https:/go.microsoft.com/fwlink/?LinkID=113216).



INPUTS

System.Object

The User or Wave object.





OUTPUTS



---------- EXAMPLE 1 ----------



Start-BTCutover -User 356

Start-BTCutover -User joe@contoso.com

Start-BTCutover -User $user

Starts a Cutover for a User by id, identity, or User object.



---------- EXAMPLE 2 ----------



Start-BTCutover -Wave 356

Start-BTCutover -Wave 'My Wave'

Start-BTCutover -Wave $wave

Starts a Cutover for a Wave by id, identity, or Wave object.



---------- EXAMPLE 3 ----------



$usersOrWaves | Start-BTCutover

Starts a Cutover for each input object, which can be a User or a Wave object.





RELATED LINKS