Get-AzRecoveryServicesBackupItem

Módulo:
Az.RecoveryServices Module

Obtém os itens de um contêiner no Backup.

Sintaxe

GetItemsForContainer (Predefinição) 

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>]

Descrição

O cmdlet Get-AzRecoveryServicesBackupItem obtém a lista de itens protegidos em um contêiner e o status de proteção dos itens. Um contentor registado num cofre de Serviços de Recuperação Azure pode ter um ou mais itens que podem ser protegidos. Para máquinas virtuais Azure, só pode haver um item de backup no contentor da máquina virtual. Defina o contexto do vault usando o parâmetro -VaultId.

Exemplos

Exemplo 1: Obter um item de um contêiner de backup

$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

O primeiro comando obtém o contêiner do tipo AzureVM e o armazena na variável $Container. O segundo comando obtém o item de backup chamado V2VM no $Container e, em seguida, armazena-o na variável $BackupItem.

Exemplo 2: Obtenha um item de partilha de ficheiros Azure através do 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"

O primeiro comando obtém o contêiner do tipo AzureStorage e o armazena na variável $Container. O segundo comando obtém o item Backup cujo friendlyName corresponde ao valor passado no parâmetro FriendlyName e, em seguida, armazena-o na variável $BackupItem. Usar o parâmetro FriendlyName pode resultar em devolver mais do que um Partilha de Ficheiros Azure. Nesses casos, execute o cmdlet passando o valor para -Name parâmetro como a propriedade Name retornada no conjunto de resultados de $BackupItem.

Exemplo 3: Listar itens de Partilha de Ficheiros do Azure apagados suavemente

$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

Lista Azure itens de backup do File Share que foram desativados com Disable-AzRecoveryServicesBackupProtection -RemoveRecoveryPoints e que estão atualmente no estado de eliminação suave. Estes itens podem ser reidratados Undo-AzRecoveryServicesBackupItemDeletion ainda dentro da janela de retenção de eliminação suave.

Exemplo 4: Obtenha um item de partilha de ficheiros Azure da região secundária (Restauro entre Regiões)

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

O item devolvido pode ser usado com Get-AzRecoveryServicesBackupRecoveryPoint -UseSecondaryRegion e Restore-AzRecoveryServicesBackupItem -RestoreToSecondaryRegion para realizar uma Restauração Interregional.

Parâmetros

-BackupManagementType

A classe de recursos que estão sendo protegidos. Os valores aceitáveis para este parâmetro são:

  • AzureVM
  • MAB
  • AzureStorage
  • AzureWorkload

Propriedades dos parâmetros

Tipo:BackupManagementType
Valor predefinido:None
Valores aceites:AzureVM, MAB, AzureStorage, AzureWorkload
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

GetItemsForVault
Posto:1
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-Container

Especifica um objeto de contêiner do qual esse cmdlet obtém itens de backup. Para obter um AzureRmRecoveryServicesBackupContainer, use o cmdlet Get-AzRecoveryServicesBackupContainer .

Propriedades dos parâmetros

Tipo:ContainerBase
Valor predefinido:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

GetItemsForContainer
Posto:1
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

-DefaultProfile

As credenciais, a conta, o locatário e a assinatura usados para comunicação com o azure.

Propriedades dos parâmetros

Tipo:IAzureContextContainer
Valor predefinido:None
Suporta carateres universais:False
NãoMostrar:False
Aliases:AzContext, AzureRmContext, AzureCredential

Conjuntos de parâmetros

(All)
Posto:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-DeleteState

Especifica o deletestate do item Os valores aceitáveis para este parâmetro são:

  • ToBeDeleted
  • NotDeleted

Propriedades dos parâmetros

Tipo:ItemDeleteState
Valor predefinido:None
Valores aceites:ToBeDeleted, NotDeleted
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Posto:6
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-FriendlyName

FriendlyName do item de backup

Propriedades dos parâmetros

Tipo:String
Valor predefinido:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Posto:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-Name

Especifica o nome do item de backup. Para compartilhamento de arquivos, especifique a ID exclusiva do compartilhamento de arquivos protegido.

Propriedades dos parâmetros

Tipo:String
Valor predefinido:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Posto:2
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-Policy

Objeto da política de proteção.

Propriedades dos parâmetros

Tipo:PolicyBase
Valor predefinido:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

GetItemsForPolicy
Posto:1
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-ProtectionState

Especifica o estado de proteção. Os valores aceitáveis para este parâmetro são:

  • IRPending. A sincronização inicial não foi iniciada e ainda não há ponto de recuperação.
  • Protegido. A proteção está em curso.
  • ProtectionError. Há um erro de proteção.
  • ProteçãoParada. A proteção está desativada.

Propriedades dos parâmetros

Tipo:ItemProtectionState
Valor predefinido:None
Valores aceites:IRPending, ProtectionError, Protected, ProtectionStopped, BackupsSuspended
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Posto:4
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-ProtectionStatus

Especifica o status geral de proteção de um item no contêiner. Os valores aceitáveis para este parâmetro são:

  • Saudável
  • Unhealthy

Propriedades dos parâmetros

Tipo:ItemProtectionStatus
Valor predefinido:None
Valores aceites:Healthy, Unhealthy
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Posto:3
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-UseSecondaryRegion

Filtros da região secundária para restauração entre regiões

Propriedades dos parâmetros

Tipo:SwitchParameter
Valor predefinido:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Posto:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-VaultId

ID ARM do Cofre dos Serviços de Recuperação.

Propriedades dos parâmetros

Tipo:String
Valor predefinido:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Posto:Named
Obrigatório:False
Valor do pipeline:True
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-WorkloadType

Tipo de carga de trabalho do recurso. Os valores aceitáveis para este parâmetro são:

  • AzureVM
  • AzureFiles
  • MSSQL
  • FileFolder
  • SAPHanaDatabase

Propriedades dos parâmetros

Tipo:WorkloadType
Valor predefinido:None
Valores aceites:AzureVM, AzureFiles, MSSQL, FileFolder, SAPHanaDatabase
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

GetItemsForContainer
Posto:5
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
GetItemsForVault
Posto:5
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

Entradas

ContainerBase

String

Saídas

ItemBase