Start-OBUnregistration

Applies To: Windows Server 2012 R2 Preview

Start-OBUnregistration

Unregisters the current computer with Windows Azure Backup.

Syntax

Parameter Set: Default
Start-OBUnregistration [[-Server] <CBBackupServer> ] [-Credential] <PSCredential> [-Confirm] [-WhatIf] [ <CommonParameters>]

Detailed Description

The Start-OBUnregistration cmdlet unregisters the current computer with Windows Azure Backup. The recovery points for this server would be cleaned up and all the backed up data would be deleted. The valid credentials (username and password) are required to authenticate the operation.

This cmdlet supports WhatIf and Confirm parameters with a high impact. The high impact signifies that the cmdlet will prompt the user for confirmation by default. The WhatIf parameter gives a verbose description of what the cmdlet does without performing any operation. The Confirm parameter specifies whether the cmdlet should prompt the user. Using –Confirm:$FALSE will override the prompt.

To use Windows Azure Backup cmdlets, the user must be a member of the Administrators group or Backup Operators group.

Parameters

-Credential<PSCredential>

Specifies the username and password used for authentication to perform the operation.

Aliases

none

Required?

true

Position?

2

Default Value

none

Accept Pipeline Input?

True (ByValue)

Accept Wildcard Characters?

false

-Server<CBBackupServer>

Specifies the server which needs be unregistered.

Aliases

none

Required?

false

Position?

1

Default Value

none

Accept Pipeline Input?

True (ByValue)

Accept Wildcard Characters?

false

-Confirm

Prompts you for confirmation before running the cmdlet.

Required?

false

Position?

named

Default Value

false

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

Required?

false

Position?

named

Default Value

false

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

<CommonParameters>

This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see    about_CommonParameters.

Inputs

The input type is the type of the objects that you can pipe to the cmdlet.

  • None

Outputs

The output type is the type of the objects that the cmdlet emits.

  • None

Examples

EXAMPLE 1

This example unregisters a computer.

PS C:\> $pwd = ConvertTo-SecureString -String Notag00dpa55word -AsPlainText –Force
PS C:\> New-Object -TypeName System.Management.Automation.PsCredential -ArgumentList contoso\johnj99, $pwd | Start-OBUnRegistration

ConvertTo-SecureString

New-Object