Remove-WBBackupTarget

Windows Server 2012 R2 and Windows 8.1

Remove-WBBackupTarget

Removes backup storage locations from a backup policy.

구문

Parameter Set: Default
Remove-WBBackupTarget [-Policy] <WBPolicy> [-Target] <WBBackupTarget> [ <CommonParameters>]




자세한 설명

The Remove-WBBackupTarget cmdlet removes backup storage locations from a backup policy. WBBackupTarget objects define backup storage locations. A WBPolicy object defines the backup policy.

Before you can remove a backup target from a WBPolicy object, you must put the WBPolicy object in edit mode. To put the WBPolicy object in edit mode for a policy that you have set as the scheduled backup policy, use the Get-WBPolicy cmdlet with the Editable parameter. The New-WBPolicy cmdlet creates a new WBPolicy object that is already in edit mode.

If you specify a disk as a storage location for backups, the server formats the disk before use and permanently deletes any existing data on the disk.

You can add only one storage type at a time to a policy. If you specify a shared folder as the storage location, you cannot add more locations because you can specify only one shared folder as a storage location at any time. However, you can specify multiple disks or volumes at one time by calling the Add-WBBackupTarget cmdlet for each location.

To use this cmdlet, you must be a member of the Administrators group or Backup Operators group.

매개 변수

-Policy<WBPolicy>

Specifies the WBPolicy object that contains the backup policy to update.


별칭

없음

필수 여부

true

위치

1

기본값

없음

파이프라인 입력 적용 여부

True (ByPropertyName)

와일드카드 문자 허용 여부

false

-Target<WBBackupTarget>

Specifies a backup target object that specifies the backup storage location to remove from the WBPolicy object.


별칭

없음

필수 여부

true

위치

2

기본값

없음

파이프라인 입력 적용 여부

True (ByPropertyName)

와일드카드 문자 허용 여부

false

<CommonParameters>

이 cmdlet은 일반 매개 변수 -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer 및 -OutVariable을 지원합니다. 자세한 내용은 다음을 참조하세요. about_CommonParameters(http://go.microsoft.com/fwlink/p/?LinkID=113216).

입력

입력 유형은 cmdlet에 파이프할 수 있는 개체의 유형입니다.

  • WBBackupTarget, WBPolicy

    The Remove-WBBackupTarget cmdlet removes a WBBackupTarget object from a WBPolicy object that contains the backup policy.


출력

출력 유형은 cmdlet이 내보내는 개체의 유형입니다.

  • WBBackupTarget[]

    The Remove-WBBackupTarget cmdlet displays a list of WBBackupTarget objects left in the policy.


예제

Example 1: Remove a backup target from a backup policy

This example removes a WBBackupTarget object from a WBPolicy object and then displays a list of backup locations left in the policy.

The first command gets the current backup policy and stores it in a variable named $Policy.

The second command gets the backup target locations and stores them in the variable named $BackupLocations. It also stores the backup policy in the variable named $Policy.

The third command removes the backup target in the first element of the $BackupLocations array from the policy stored in the $Policy variable.


PS C:\> $Policy = Get-WBPolicy
PS C:\> $BackupLocations = Get-WBBackupTarget -Policy $Policy
PS C:\> Remove-WBBackupTarget -Policy $Policy -Target $BackupLocations[0]

관련 항목

커뮤니티 추가 항목

추가
표시: