Get-WBPolicy
Get-WBPolicy
Retrieves the current backup policy for the computer.
Syntax
Parameter Set: Default
Get-WBPolicy [-Editable] [ <CommonParameters>]
Detailed Description
The Get-WBPolicy cmdlet retrieves the backup policy object for the computer. Use the Editable parameter to return the policy information in edit mode.
To use this or any other Windows Server 2012 Backup cmdlets, you must be a member of the Administrators group or Backup Operators group.
Parameters
-Editable
Indicates that the cmdlet returns a current backup policy in edit mode.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
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 (https://go.microsoft.com/fwlink/p/?LinkID=113216).
Inputs
The input type is the type of the objects that you can pipe to the cmdlet.
Editable
This cmdlet uses the Editable parameter to set the WBPolicy object in edit mode.
Outputs
The output type is the type of the objects that the cmdlet emits.
WBPolicy
This cmdlet displays the WBPolicy object. The cmdlet returns a null value if no backup policy is set.
Notes
- If you use the Editable parameter to make changes, set the updated policy as the current policy by using the Set-WBPolicy cmdlet.
Examples
Example 1: Get a current backup policy
This command gets information about the backup policy object. The information includes all the settings for the backup policy, such as what items to back up, when to run backups, and where to store backups.
PS C:\> Get-WBPolicy
Example 2: Get a current backup policy in edit mode
This command gets information about the backup policy object, and it makes the policy editable.
PS C:\> Get-WBPolicy -Editable