Get-WBVolume
Get-WBVolume
Retrieves a list of volumes.
構文
Parameter Set: Disk
Get-WBVolume [-Disk] <WBDisk> [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: AllVolumes
Get-WBVolume [-AllVolumes] [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: CriticalVolumes
Get-WBVolume [-CriticalVolumes] [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: Policy
Get-WBVolume [-Policy] <WBPolicy> [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: VolumePath
Get-WBVolume [-VolumePath] <String[]> [-Confirm] [-WhatIf] [ <CommonParameters>]
詳細説明
The Get-WBVolume cmdlet retrieves a list of volumes. Use this cmdlet to display volumes included in the WBPolicy object, all critical volumes, all volumes, or volumes in the WBDisk object. You can also use this cmdlet to get a WBVolume object of a volume by using the drive letter of that volume.
To use this cmdlet, you must be a member of the Administrators group or Backup Operators group.
パラメーター
-AllVolumes
Indicates whether to list all volumes included in the backup policy.
エイリアス |
なし |
必須? |
true |
位置は? |
1 |
既定値 |
なし |
パイプライン入力を許可する |
false |
ワイルドカード文字を許可する |
false |
-CriticalVolumes
Indicates whether to list only critical volumes, such as volumes that contain operating system files and components.
エイリアス |
なし |
必須? |
true |
位置は? |
1 |
既定値 |
なし |
パイプライン入力を許可する |
false |
ワイルドカード文字を許可する |
false |
-Disk<WBDisk>
Indicates whether to list only volumes associated with a certain disk.
エイリアス |
OnDisk |
必須? |
true |
位置は? |
1 |
既定値 |
なし |
パイプライン入力を許可する |
True (ByValue, ByPropertyName) |
ワイルドカード文字を許可する |
false |
-Policy<WBPolicy>
Specifies the policy contained in the WBPolicy object to display.
エイリアス |
InPolicy |
必須? |
true |
位置は? |
1 |
既定値 |
なし |
パイプライン入力を許可する |
True (ByValue, ByPropertyName) |
ワイルドカード文字を許可する |
false |
-VolumePath<String[]>
Specifies a volume drive letter for the volume where you will store the backups.
エイリアス |
なし |
必須? |
true |
位置は? |
1 |
既定値 |
なし |
パイプライン入力を許可する |
false |
ワイルドカード文字を許可する |
false |
-Confirm
コマンドレットを実行する前に、ユーザーに確認を求めます。
必須? |
false |
位置は? |
named |
既定値 |
false |
パイプライン入力を許可する |
false |
ワイルドカード文字を許可する |
false |
-WhatIf
コマンドレットを実行するとどのような結果になるかを表示します。コマンドレットは実行されません。
必須? |
false |
位置は? |
named |
既定値 |
false |
パイプライン入力を許可する |
false |
ワイルドカード文字を許可する |
false |
<CommonParameters>
このコマンドレットは次の共通パラメーターをサポートします。-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer、-OutVariable.詳細については、以下を参照してください。 about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216)。
入力
入力型は、コマンドレットにパイプできるオブジェクトの型です。
WBPolicy,WBDisk,string
The Get-WBVolume cmdlet queries the WBPolicy object and the WBDisk object, and it references a string that specifies a path to the volumes where you will store the backups.
Depending on the input parameters, you can use the Get-WBVolume cmdlet to query the WBPolicy object for a list of volumes specified for backup, query the WBDisk object for a list of volumes present on a particular disk, or get a WBVolume object of the volume that the string specifies VolumePath parameter.
In addition, you can use the Get-WBVolume cmdlet with the parameters CriticalVolumes and AllVolumes to get the WBVolume list of all critical volumes on the system and all the volumes on the system, respectively.
出力
出力型は、コマンドレットによって生成されるオブジェクトの型です。
WBVolume []
The Get-WBVolume cmdlet displays the array of volumes in the WBPolicy object.
注
- You can add the volumes that you get from Get-WBVolume to the WBPolicy object by using the Add-WBVolume cmdlet to specify them as volumes to be backed up, or by using the New-WBBackupTarget cmdlet to specify them as backup storage locations.
例
Example 1: Get a list of volumes on a disk
This example gets all volumes present on a disk.
The first command stores the output of the Get-WBDisk cmdlet in the $Disks variable. The command retrieves a list of all disks on the system.
The second command uses the Get-WBVolume cmdlet to get a list of volumes on the first disk.
PS C:\> $Disks = Get-WBDisk
PS C:\> Get-WBVolume -Disk $Disks[0]
Example 2: Get a list of all volumes in the backup policy
This example gets a list of all volumes that you added for backup in the WBPolicy object.
The first command stores the result of the Get-WBPolicy cmdlet in a variable named $Policy.
The second command gets the volumes from the $Policy variable.
PS C:\> $Policy = Get-WBPolicy
PS C:\> Get-WBVolume -Policy $Policy
Example 3: Get volumes for a specific drive letter
This command gets the WBVolume object for the volume that uses drive letter E:.
PS C:\> Get-WBVolume -VolumePath E:
Example 4: Get all volumes on a computer
This command gets a list of WBVolume objects of all the volumes present on the computer.
PS C:\> Get-WBVolume -AllVolumes
Example 5: Get all critical volumes on a computer
This command gets the list of all the critical volumes present on the computer. Critical volumes are volumes that contain operating system components and files.
PS C:\> Get-WBVolume -CriticalVolumes