Partilhar via

Get-AzStorageBlobCopyState

Módulo:
Az.Storage Module

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

Sintaxe

NamePipeline (Predefinição) 

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

BlobPipeline 

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

ContainerPipeline 

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

Description

O cmdlet Get-AzStorageBlobCopyState recebe o estado de cópia de um blob Armazenamento do Azure. Ele deve ser executado no blob de destino da cópia.

Exemplos

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

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

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

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

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

Este 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 da cópia desse blob.

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

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

Este 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 da cópia para o blob chamado ContosoPlanning2015 nesse contêiner.

Exemplo 4: Iniciar cópia e 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 a cópia do blob "ContosoPlanning2015" para "ContosoPlanning2015_copy" e a saída do 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 de blob.

Parâmetros

-Blob

Especifica o nome de um blob. Este cmdlet obtém o estado da operação de cópia do blob para o blob do Armazenamento do Azure que este parâmetro especifica.

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

NamePipeline
Position:0
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
ContainerPipeline
Position:0
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos: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 tentará novamente a solicitação. Se este cmdlet não receber uma resposta bem-sucedida antes do intervalo passar, ele retornará um erro.

Propriedades dos parâmetros

Tipo:

Nullable<T>[Int32]

Default value:None
Suporta carateres universais:False
NãoMostrar:False
Aliases:ClientTimeoutPerRequestInSeconds

Conjuntos de parâmetros

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

-CloudBlob

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

Propriedades dos parâmetros

Tipo:Microsoft.Azure.Storage.Blob.CloudBlob
Default value:None
Suporta carateres universais:False
NãoMostrar:False
Aliases:ICloudBlob

Conjuntos de parâmetros

BlobPipeline
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

-CloudBlobContainer

Especifica um objeto CloudBlobContainer da biblioteca cliente Armazenamento do Azure. Este 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.

Propriedades dos parâmetros

Tipo:Microsoft.Azure.Storage.Blob.CloudBlobContainer
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

ContainerPipeline
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos: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 principal. 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 predefinido é 10.

Propriedades dos parâmetros

Tipo:

Nullable<T>[Int32]

Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

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

-Container

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

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

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

-Context

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

Propriedades dos parâmetros

Tipo:IStorageContext
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

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

-DefaultProfile

As credenciais, conta, inquilino e subscrição usados para comunicação com o Azure.

Propriedades dos parâmetros

Tipo:IAzureContextContainer
Default value:None
Suporta carateres universais:False
NãoMostrar:False
Aliases:AzureRmContext, AzureCredential

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos: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 de o serviço processar a solicitação, o serviço de armazenamento retornará um erro.

Propriedades dos parâmetros

Tipo:

Nullable<T>[Int32]

Default value:None
Suporta carateres universais:False
NãoMostrar:False
Aliases:ServerTimeoutPerRequestInSeconds

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos: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.

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
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

Microsoft.Azure.Storage.Blob.CloudBlob

Microsoft.Azure.Storage.Blob.CloudBlobContainer

IStorageContext

Saídas

Microsoft.Azure.Storage.Blob.CopyState