Update-DPMPGSet
Update-DPMPGSet
Updates and saves changes to a PG set.
構文
Parameter Set: AllParams
Update-DPMPGSet [-PGSet] <PGSet> [-Name] <String> [-WritePeriodUnit] <PGSet+TimeUnit> {Invalid | Day | Week | Month | Year} [[-AllowDifferentRetentionPeriods]] [-WritePeriodValue] <UInt32> [-ExpiryToleranceUnit] <PGSet+TimeUnit> {Invalid | Day | Week | Month | Year} [-ExpiryToleranceValue] <UInt32> [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: AddPG
Update-DPMPGSet [-PGSet] <PGSet> [-Add] <ProtectionGroup> [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: AllowDiffRetnPeriodsFlag
Update-DPMPGSet [-PGSet] <PGSet> [-AllowDifferentRetentionPeriods] [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: ChangeName
Update-DPMPGSet [-PGSet] <PGSet> [-Name] <String> [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: ChangeTimePeriods
Update-DPMPGSet [-PGSet] <PGSet> [-WritePeriodUnit] <PGSet+TimeUnit> {Invalid | Day | Week | Month | Year} [-WritePeriodValue] <UInt32> [-ExpiryToleranceUnit] <PGSet+TimeUnit> {Invalid | Day | Week | Month | Year} [-ExpiryToleranceValue] <UInt32> [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: RemovePG
Update-DPMPGSet [-PGSet] <PGSet> [-Remove] <ProtectionGroup> [-Confirm] [-WhatIf] [ <CommonParameters>]
詳細説明
The Update-DPMPGSet cmdlet updates and saves changes to a System Center 2012 – Data Protection Manager (DPM) protection group (PG) set. A DPM PG is a collection of protection groups that you collocate on the same tape.
パラメーター
-Add<ProtectionGroup>
Specifies a protection group. The cmdlet adds this PG to the PG set.
エイリアス |
none |
必須? |
true |
位置は? |
2 |
既定値 |
none |
パイプライン入力を許可する |
false |
ワイルドカード文字を許可する |
false |
-AllowDifferentRetentionPeriods
Indicates that protection groups with different retention periods can be part of the same PG set.
エイリアス |
none |
必須? |
true |
位置は? |
2 |
既定値 |
none |
パイプライン入力を許可する |
false |
ワイルドカード文字を許可する |
false |
-ExpiryToleranceUnit<PGSet+TimeUnit>
Specifies the measurement unit for expiry tolerance.
エイリアス |
none |
必須? |
true |
位置は? |
4 |
既定値 |
none |
パイプライン入力を許可する |
false |
ワイルドカード文字を許可する |
false |
-ExpiryToleranceValue<UInt32>
Specifies the maximum length of time for which an expired recovery point can remain on a tape until DPM marks the tape as expired.
エイリアス |
none |
必須? |
true |
位置は? |
5 |
既定値 |
none |
パイプライン入力を許可する |
false |
ワイルドカード文字を許可する |
false |
-Name<String>
Specifies a new name for the PG set.
エイリアス |
none |
必須? |
true |
位置は? |
2 |
既定値 |
none |
パイプライン入力を許可する |
false |
ワイルドカード文字を許可する |
false |
-PGSet<PGSet>
Specifies a PG set to update.
エイリアス |
none |
必須? |
true |
位置は? |
1 |
既定値 |
none |
パイプライン入力を許可する |
True (ByValue) |
ワイルドカード文字を許可する |
false |
-Remove<ProtectionGroup>
Specifies a protection group. The cmdlet removes this PG from the PG set.
エイリアス |
none |
必須? |
true |
位置は? |
2 |
既定値 |
none |
パイプライン入力を許可する |
false |
ワイルドカード文字を許可する |
false |
-WritePeriodUnit<PGSet+TimeUnit>
Specifies the measurement unit for the write period.
エイリアス |
none |
必須? |
true |
位置は? |
2 |
既定値 |
none |
パイプライン入力を許可する |
false |
ワイルドカード文字を許可する |
false |
-WritePeriodValue<UInt32>
Specifies the length of time for which a tape is available for writing new backups. DPM marks the tape as Offsite Ready after this interval.
エイリアス |
none |
必須? |
true |
位置は? |
3 |
既定値 |
none |
パイプライン入力を許可する |
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)。
入力
入力型は、コマンドレットにパイプできるオブジェクトの型です。
出力
出力型は、コマンドレットによって生成されるオブジェクトの型です。
注
- For more information, type "
Get-Help Update-DPMPGSet -detailed
".
例
Example 1: Update write period and expiry tolerance
This example updates the first PG set from PG sets on the on the server DPMServer07 with values for write period and expiry tolerance.
The first command uses the Get-DPMPGSet cmdlet to get the PG sets for the specified server and stores them in the $PgSet variable.
The second command specifies the first member of the $PgSet variable by using standard array notation. The command updates values for write period and expiry tolerance.
PS C:\> $PgSet = Get-DPMPGSet -DPMServerName "DPMServer07"PS C:\> Update-DPMPGSet -PGSet $PgSet[0] -Name "PGSset3" -WritePeriodUnit day -WritePeriodValue 60 -ExpiryToleranceUnit Day -ExpiryToleranceValue 10
Example 2: Add a PG to a PG set
This example adds a protection group from DPMServer07 to the first protection group set on that DPM server.
The first command uses the Get-DPMPGSet cmdlet to get the PG sets for the specified server and stores them in the $PgSet variable.
The second command uses the Get-DPMProtectionGroup cmdlet to get a PG from the specified DPM server that has a name that contains PG1 and stores it in the $Pg variable.
The third command specifies the first member of the $PgSet variable by using standard array notation. The command updates that set to contain the PG stored in the $Pg variable.
PS C:\> $PgSet = Get-DPMPGSet -DPMServerName "DPMServer07"PS C:\> $Pg = Get-DPMProtectionGroup -DPMServerName "DPMServer07" | where {($_.friendlyname) -match "PG1" }PS C:\> Update-DPMPGSet -PGSet $PgSet[0] -Add $Pg
Example 3: Remove a PG from a PG set
This example removes the first protection group set from the list of protection group sets on the DPM server TestingServer.
The first command uses the Get-DPMPGSet cmdlet to get the PG sets for the specified server and stores them in the $PgSet variable.
The second command uses the Get-DPMProtectionGroup cmdlet to get a PG from the specified DPM server that has a name that contains PG1 and stores it in the $Pg variable.
The third command specifies the first member of the $PgSet variable by using standard array notation. The command updates that set to no longer contain the PG stored in the $Pg variable.
PS C:\> $PgSet = Get-DPMPGSet -DPMServerName "DPMServer07"PS C:\> $Pg = Get-ProtectionGroup -DPMServerName "DPMServer07" | where { ($_.friendlyname) -match "PG1" }PS C:\> Update-DPMPGSet -PGSet $PgSet[0] -Remove $Pg