Get-AzStorageBlobCopyState

  • Referentie
Module:
Az.Storage

Hiermee haalt u de kopieerstatus van een Azure Storage-blob op.

Syntax

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

De cmdlet Get-AzStorageBlobCopyState haalt de kopieerstatus van een Azure Storage-blob op. Deze moet worden uitgevoerd op de blob van de kopieerbestemming.

Voorbeelden

Voorbeeld 1: de kopieerstatus van een blob ophalen

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

Met deze opdracht wordt de kopieerstatus van de blob met de naam ContosoPlanning2015 in de container ContosoUploads ophaalt.

Voorbeeld 2: de kopieerstatus voor een blob ophalen met behulp van de pijplijn

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

Met deze opdracht haalt u de blob met de naam ContosoPlanning2015 op in de container met de naam ContosoUploads met behulp van de Cmdlet Get-AzStorageBlob en geeft u het resultaat vervolgens door aan de huidige cmdlet met behulp van de pijplijnoperator. De cmdlet Get-AzStorageBlobCopyState haalt de kopieerstatus voor die blob op.

Voorbeeld 3: De kopieerstatus voor een blob in een container ophalen met behulp van de pijplijn

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

Met deze opdracht haalt u de container met de naam op met behulp van de Get-AzStorageBlob-cmdlet en geeft u vervolgens het resultaat door aan de huidige cmdlet. De cmdlet Get-AzStorageContainer haalt de kopieerstatus op voor de blob met de naam ContosoPlanning2015 in die container.

Voorbeeld 4: Kopieer en pijplijn starten om de kopieerstatus op te halen

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

$destBlob | Get-AzStorageBlobCopyState

Met de eerste opdracht wordt de blob ContosoPlanning2015 naar ContosoPlanning2015_copy gekopieerd en wordt het blobobject destiantion uitgevoerd. Met de tweede opdrachtpijplijn wordt het blobobject van de destiantion naar Get-AzStorageBlobCopyState geleid om de blobkopiestatus op te halen.

Parameters

-Blob

Hiermee geeft u de naam van een blob. Deze cmdlet haalt de status van de blobkopiebewerking op voor de Azure Storage-blob die met deze parameter wordt opgegeven.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ClientTimeoutPerRequest

Hiermee geeft u het time-outinterval aan de clientzijde op, in seconden, voor één serviceaanvraag. Als de vorige aanroep mislukt in het opgegeven interval, probeert deze cmdlet de aanvraag opnieuw uit te voeren. Als deze cmdlet geen geslaagd antwoord ontvangt voordat het interval is verstreken, retourneert deze cmdlet een fout.

Type:Nullable<T>[Int32]
Aliases:ClientTimeoutPerRequestInSeconds
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-CloudBlob

Hiermee geeft u een CloudBlob-object op uit de Azure Storage-clientbibliotheek. Gebruik de cmdlet Get-AzStorageBlob om een CloudBlob-object te verkrijgen.

Type:CloudBlob
Aliases:ICloudBlob
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-CloudBlobContainer

Hiermee geeft u een CloudBlobContainer-object op uit de Azure Storage-clientbibliotheek. Deze cmdlet haalt de kopieerstatus van een blob op in de container die met deze parameter wordt opgegeven. Gebruik de cmdlet Get-AzStorageContainer om een CloudBlobContainer-object op te halen.

Type:CloudBlobContainer
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ConcurrentTaskCount

Hiermee geeft u het maximum aantal gelijktijdige netwerkaanroepen op. U kunt deze parameter gebruiken om de gelijktijdigheid te beperken om het lokale CPU- en bandbreedtegebruik te beperken door het maximum aantal gelijktijdige netwerkaanroepen op te geven. De opgegeven waarde is een absoluut aantal en wordt niet vermenigvuldigd met het aantal kernen. Deze parameter kan helpen bij het verminderen van netwerkverbindingsproblemen in omgevingen met lage bandbreedte, zoals 100 kilobits per seconde. De standaardwaarde is 10.

Type:Nullable<T>[Int32]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Container

Hiermee geeft u de naam van een container. Deze cmdlet haalt de kopieerstatus voor een blob op in de container die met deze parameter wordt opgegeven.

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Context

Hiermee geeft u een Azure-opslagcontext op. Gebruik de cmdlet New-AzStorageContext om een opslagcontext te verkrijgen.

Type:IStorageContext
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-DefaultProfile

De referenties, accounts, tenants en abonnementen die worden gebruikt voor communicatie met Azure.

Type:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ServerTimeoutPerRequest

Hiermee geeft u het time-outinterval aan de servicezijde op, in seconden, voor een aanvraag. Als het opgegeven interval is verstreken voordat de service de aanvraag verwerkt, retourneert de opslagservice een fout.

Type:Nullable<T>[Int32]
Aliases:ServerTimeoutPerRequestInSeconds
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WaitForComplete

Geeft aan dat deze cmdlet wacht totdat de kopie is voltooid. Als u deze parameter niet opgeeft, retourneert deze cmdlet onmiddellijk een resultaat.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Invoerwaarden

CloudBlob

CloudBlobContainer

IStorageContext

Uitvoerwaarden

CopyState