Get-AzRecoveryServicesBackupItem

Module:
Az.RecoveryServices Module

Haalt de items op uit een container in Backup.

Syntax

GetItemsForContainer (Standaard) 

Get-AzRecoveryServicesBackupItem
    [-Container] <ContainerBase>
    [[-Name] <String>]
    [[-ProtectionStatus] <ItemProtectionStatus>]
    [[-ProtectionState] <ItemProtectionState>]
    [-WorkloadType] <WorkloadType>
    [[-DeleteState] <ItemDeleteState>]
    [-FriendlyName <String>]
    [-VaultId <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [-UseSecondaryRegion]
    [<CommonParameters>]

GetItemsForVault 

Get-AzRecoveryServicesBackupItem
    [-BackupManagementType] <BackupManagementType>
    [[-Name] <String>]
    [[-ProtectionStatus] <ItemProtectionStatus>]
    [[-ProtectionState] <ItemProtectionState>]
    [-WorkloadType] <WorkloadType>
    [[-DeleteState] <ItemDeleteState>]
    [-FriendlyName <String>]
    [-VaultId <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [-UseSecondaryRegion]
    [<CommonParameters>]

GetItemsForPolicy 

Get-AzRecoveryServicesBackupItem
    [-Policy] <PolicyBase>
    [[-Name] <String>]
    [[-ProtectionStatus] <ItemProtectionStatus>]
    [[-ProtectionState] <ItemProtectionState>]
    [[-DeleteState] <ItemDeleteState>]
    [-FriendlyName <String>]
    [-VaultId <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [-UseSecondaryRegion]
    [<CommonParameters>]

Description

De cmdlet Get-AzRecoveryServicesBackupItem haalt de lijst met beveiligde items op in een container en de beveiligingsstatus van de items. Een container die is geregistreerd bij een Azure Recovery Services-kluis kan een of meer items bevatten die kunnen worden beveiligd. Voor Azure virtuele machines kan er slechts één back-upitem in de container van de virtuele machine staan. Stel de kluiscontext in met behulp van de parameter -VaultId.

Voorbeelden

Voorbeeld 1: Een item ophalen uit een back-upcontainer

$vault = Get-AzRecoveryServicesVault -ResourceGroupName "resourceGroup" -Name "vaultName"
$Container = Get-AzRecoveryServicesBackupContainer -ContainerType AzureVM -FriendlyName "V2VM" -VaultId $vault.ID
$BackupItem = Get-AzRecoveryServicesBackupItem -Container $Container -WorkloadType AzureVM -VaultId $vault.ID

Met de eerste opdracht wordt de container van het type AzureVM opgehaald en vervolgens opgeslagen in de variabele $Container. Met de tweede opdracht wordt het back-upitem met de naam V2VM in $Container opgehaald en vervolgens opgeslagen in de $BackupItem variabele.

Voorbeeld 2: een Azure-bestandsshareitem ophalen uit FriendlyName

$vault = Get-AzRecoveryServicesVault -ResourceGroupName "resourceGroup" -Name "vaultName"
$Container = Get-AzRecoveryServicesBackupContainer -ContainerType AzureStorage -FriendlyName "StorageAccount1" -VaultId $vault.ID
$BackupItem = Get-AzRecoveryServicesBackupItem -Container $Container -WorkloadType AzureFiles -VaultId $vault.ID -FriendlyName "FileShareName"

Met de eerste opdracht wordt de container van het type AzureStorage opgeslagen en vervolgens opgeslagen in de variabele $Container. Met de tweede opdracht wordt het back-upitem opgehaald waarvan friendlyName overeenkomt met de waarde die is doorgegeven in de parameter FriendlyName en slaat het vervolgens op in de $BackupItem variabele. Het gebruik van de parameter FriendlyName kan resulteren in het retourneren van meer dan één Azure bestandsshare. In dergelijke gevallen voert u de cmdlet uit door de waarde voor -Name parameter door te geven als de eigenschap Name die wordt geretourneerd in de resultatenset van $BackupItem.

Voorbeeld 3: voorlopig verwijderde Azure bestandsshareitems weergeven

$vault = Get-AzRecoveryServicesVault -ResourceGroupName "resourceGroup" -Name "vaultName"
$Container = Get-AzRecoveryServicesBackupContainer -ContainerType AzureStorage -FriendlyName "StorageAccount1" -VaultId $vault.ID
$softDeletedItems = Get-AzRecoveryServicesBackupItem -Container $Container -WorkloadType AzureFiles -VaultId $vault.ID -DeleteState ToBeDeleted

Bevat Azure back-upitems voor bestandsshares die zijn uitgeschakeld met Disable-AzRecoveryServicesBackupProtection -RemoveRecoveryPoints en die momenteel de status Voorlopig verwijderd hebben. Deze items kunnen worden gerehydrateerd terwijl Undo-AzRecoveryServicesBackupItemDeletion ze zich nog in het bewaarvenster voor voorlopig verwijderen bevinden.

Voorbeeld 4: Een Azure bestandsshareitem ophalen uit de secundaire regio (herstellen tussen regio's)

$vault = Get-AzRecoveryServicesVault -ResourceGroupName "resourceGroup" -Name "vaultName"
$BackupItem = Get-AzRecoveryServicesBackupItem -BackupManagementType AzureStorage -WorkloadType AzureFiles -VaultId $vault.ID -FriendlyName "FileShareName" -UseSecondaryRegion

Het geretourneerde item kan worden gebruikt met Get-AzRecoveryServicesBackupRecoveryPoint -UseSecondaryRegion en Restore-AzRecoveryServicesBackupItem -RestoreToSecondaryRegion om een herstelbewerking tussen regio's uit te voeren.

Parameters

-BackupManagementType

De klasse resources die worden beveiligd. De acceptabele waarden voor deze parameter zijn:

  • AzureVM
  • MAB
  • AzureStorage
  • AzureWorkload

Parametereigenschappen

Type:BackupManagementType
Default value:None
Geaccepteerde waarden:AzureVM, MAB, AzureStorage, AzureWorkload
Ondersteunt jokertekens:False
DontShow:False

Parametersets

GetItemsForVault
Position:1
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-Container

Hiermee geeft u een containerobject van waaruit deze cmdlet back-upitems ophaalt. Gebruik de cmdlet Get-AzRecoveryServicesBackupContainer om een AzureRmRecoveryServicesBackupContainer te verkrijgen.

Parametereigenschappen

Type:ContainerBase
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

GetItemsForContainer
Position:1
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-DefaultProfile

De referenties, het account, de tenant en het abonnement die worden gebruikt voor communicatie met Azure.

Parametereigenschappen

Type:IAzureContextContainer
Default value:None
Ondersteunt jokertekens:False
DontShow:False
Aliassen:AzContext, AzureRmContext, AzureCredential

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-DeleteState

Hiermee geeft u de deletestate van het item De acceptabele waarden voor deze parameter zijn:

  • ToBeDeleted
  • NotDeleted

Parametereigenschappen

Type:ItemDeleteState
Default value:None
Geaccepteerde waarden:ToBeDeleted, NotDeleted
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:6
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-FriendlyName

FriendlyName van het item waarvan een back-up is gemaakt

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-Name

Hiermee geeft u de naam van het back-upitem. Geef voor bestandsshare de unieke id van de beveiligde bestandsshare op.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:2
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-Policy

Beveiligingsbeleidsobject.

Parametereigenschappen

Type:PolicyBase
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

GetItemsForPolicy
Position:1
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-ProtectionState

Hiermee geeft u de status van de beveiliging. De acceptabele waarden voor deze parameter zijn:

  • IRPending. De initiële synchronisatie is nog niet gestart en er is nog geen herstelpunt.
  • Beschermd. De beveiliging is gaande.
  • ProtectionError. Er is een beveiligingsfout opgetreden.
  • ProtectionStopped. Beveiliging is uitgeschakeld.

Parametereigenschappen

Type:ItemProtectionState
Default value:None
Geaccepteerde waarden:IRPending, ProtectionError, Protected, ProtectionStopped, BackupsSuspended
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:4
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-ProtectionStatus

Hiermee geeft u de algehele beveiligingsstatus van een item in de container op. De acceptabele waarden voor deze parameter zijn:

  • Healthy
  • Unhealthy

Parametereigenschappen

Type:ItemProtectionStatus
Default value:None
Geaccepteerde waarden:Healthy, Unhealthy
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:3
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-UseSecondaryRegion

Filters uit secundaire regio voor herstel tussen regio's

Parametereigenschappen

Type:SwitchParameter
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-VaultId

ARM-id van de Recovery Services-kluis.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:True
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-WorkloadType

Workloadtype van de resource. De acceptabele waarden voor deze parameter zijn:

  • AzureVM
  • AzureFiles
  • MSSQL
  • FileFolder
  • SAPHanaDatabase

Parametereigenschappen

Type:WorkloadType
Default value:None
Geaccepteerde waarden:AzureVM, AzureFiles, MSSQL, MSSQLInstance, FileFolder, SAPHanaDatabase
Ondersteunt jokertekens:False
DontShow:False

Parametersets

GetItemsForContainer
Position:5
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False
GetItemsForVault
Position:5
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

CommonParameters

Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.

Invoerwaarden

ContainerBase

String

Uitvoerwaarden

ItemBase