Creates a new backup policy (WBPolicy object).


New-WBPolicy [<CommonParameters>]

Detailed Description

The New-WBPolicy cmdlet creates a new, empty backup policy (WBPolicy object) that is in edit mode. You can use other cmdlets to define what items will be included or excluded in backups, when backups will run, and where backups will be stored. Then, use the Set-WBPolicy cmdlet to make the new policy the one that will be used for scheduled backups. Or, use the Start-WBBackup cmdlet to start a one-time backup using the settings in the policy.



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

Input and Return Types

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


  • To use Windows Server Backup cmdlets, you must be a member of the Administrators group or Backup Operators group.



C:\PS>$policy = New-WBPolicy

An empty policy object ($policy) in edit mode.



Creates a new, empty WBPolicy object ($policy) in edit mode. The WBPolicy object created can be used to specify the settings for backup.

See Also