Get-AzStorageBlobCopyState

  • Referência
Módulo:
Az.Storage

Obtém o status de cópia de um blob de Armazenamento do Azure.

Sintaxe

Get-AzStorageBlobCopyState
   [-Blob] <String>
   [-Container] <String>
   [-WaitForComplete]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [<CommonParameters>]
Get-AzStorageBlobCopyState
   -CloudBlob <CloudBlob>
   [-WaitForComplete]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [<CommonParameters>]
Get-AzStorageBlobCopyState
   -CloudBlobContainer <CloudBlobContainer>
   [-Blob] <String>
   [-WaitForComplete]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [<CommonParameters>]

Description

O cmdlet Get-AzStorageBlobCopyState obtém o status de cópia de um blob de Armazenamento do Azure. Ele deve ser executado no blob de destino de cópia.

Exemplos

Exemplo 1: Obter o status de cópia de um blob

Get-AzStorageBlobCopyState -Blob "ContosoPlanning2015" -Container "ContosoUploads"

Esse comando obtém o status de cópia do blob chamado ContosoPlanning2015 no contêiner ContosoUploads.

Exemplo 2: Obter o status de cópia de um blob usando o pipeline

Get-AzStorageBlob -Blob "ContosoPlanning2015" -Container "ContosoUploads" | Get-AzStorageBlobCopyState

Esse comando obtém o blob chamado ContosoPlanning2015 no contêiner chamado ContosoUploads usando o cmdlet Get-AzStorageBlob e, em seguida, passa o resultado para o cmdlet atual usando o operador de pipeline. O cmdlet Get-AzStorageBlobCopyState obtém o status de cópia desse blob.

Exemplo 3: Obter o status de cópia de um blob em um contêiner usando o pipeline

Get-AzStorageContainer -Name "ContosoUploads" | Get-AzStorageBlobCopyState -Blob "ContosoPlanning2015"

Esse comando obtém o contêiner nomeado usando o cmdlet Get-AzStorageBlob e, em seguida, passa o resultado para o cmdlet atual. O cmdlet Get-AzStorageContainer obtém o status de cópia do blob chamado ContosoPlanning2015 nesse contêiner.

Exemplo 4: Inicie a cópia e o pipeline para obter o status da cópia

$destBlob = Start-AzStorageBlobCopy -SrcContainer "contosouploads" -SrcBlob "ContosoPlanning2015" -DestContainer "contosouploads2" -DestBlob "ContosoPlanning2015_copy"

$destBlob | Get-AzStorageBlobCopyState

O primeiro comando inicia copy blob "ContosoPlanning2015" para "ContosoPlanning2015_copy" e gera o objeto de blob de destino. O segundo comando canaliza o objeto de blob de destino para Get-AzStorageBlobCopyState, para obter o estado de cópia do blob.

Parâmetros

-Blob

Especifica o nome de um blob. Esse cmdlet obtém o estado da operação de cópia de blob para o blob de Armazenamento do Azure especificado por esse parâmetro.

Tipo:String
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ClientTimeoutPerRequest

Especifica o intervalo de tempo limite do lado do cliente, em segundos, para uma solicitação de serviço. Se a chamada anterior falhar no intervalo especificado, esse cmdlet repetirá a solicitação. Se esse cmdlet não receber uma resposta bem-sucedida antes do término do intervalo, ele retornará um erro.

Tipo:Nullable<T>[Int32]
Aliases:ClientTimeoutPerRequestInSeconds
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-CloudBlob

Especifica um objeto CloudBlob da biblioteca de clientes do Armazenamento do Azure. Para obter um objeto CloudBlob , use o cmdlet Get-AzStorageBlob.

Tipo:CloudBlob
Aliases:ICloudBlob
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-CloudBlobContainer

Especifica um objeto CloudBlobContainer da biblioteca de clientes do Armazenamento do Azure. Esse cmdlet obtém o status de cópia de um blob no contêiner especificado por esse parâmetro. Para obter um objeto CloudBlobContainer , use o cmdlet Get-AzStorageContainer.

Tipo:CloudBlobContainer
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-ConcurrentTaskCount

Especifica o máximo de chamadas de rede simultâneas. Você pode usar esse parâmetro para limitar a simultaneidade para limitar o uso local da CPU e da largura de banda especificando o número máximo de chamadas de rede simultâneas. O valor especificado é uma contagem absoluta e não é multiplicado pela contagem de núcleos. Esse parâmetro pode ajudar a reduzir problemas de conexão de rede em ambientes de baixa largura de banda, como 100 kilobits por segundo. O valor padrão é 10.

Tipo:Nullable<T>[Int32]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Container

Especifica o nome de um contêiner. Esse cmdlet obtém o status de cópia de um blob no contêiner especificado por esse parâmetro.

Tipo:String
Cargo:1
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Context

Especifica um contexto de armazenamento do Azure. Para obter um contexto de armazenamento, use o cmdlet New-AzStorageContext.

Tipo:IStorageContext
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-DefaultProfile

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

Tipo:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ServerTimeoutPerRequest

Especifica o intervalo de tempo limite do lado do serviço, em segundos, para uma solicitação. Se o intervalo especificado decorrer antes que o serviço processe a solicitação, o serviço de armazenamento retornará um erro.

Tipo:Nullable<T>[Int32]
Aliases:ServerTimeoutPerRequestInSeconds
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-WaitForComplete

Indica que esse cmdlet aguarda a conclusão da cópia. Se você não especificar esse parâmetro, esse cmdlet retornará um resultado imediatamente.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

CloudBlob

CloudBlobContainer

IStorageContext

Saídas

CopyState