Freigeben über


Get-AzStorageBlobCopyState

Ruft den Kopierstatus eines Azure Storage-BLOB ab.

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

Beschreibung

Das Cmdlet "Get-AzStorageBlobCopyState " ruft den Kopierstatus eines Azure Storage-BLOB ab. Er sollte auf dem Ziel-Blob für das Kopieren ausgeführt werden.

Beispiele

Beispiel 1: Abrufen des Kopierstatus eines BLOB

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

Dieser Befehl ruft den Kopierstatus des Blobs "ContosoPlanning2015" im Container "ContosoUploads" ab.

Beispiel 2: Abrufen des Kopierstatus für ein BLOB mithilfe der Pipeline

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

Dieser Befehl ruft den Blob "ContosoPlanning2015" im Container "ContosoUploads" mithilfe des Cmdlets "Get-AzStorageBlob " ab und übergibt dann das Ergebnis mithilfe des Pipelineoperators an das aktuelle Cmdlet. Das Cmdlet "Get-AzStorageBlobCopyState " ruft den Kopierstatus für dieses Blob ab.

Beispiel 3: Abrufen des Kopierstatus für ein BLOB in einem Container mithilfe der Pipeline

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

Dieser Befehl ruft den container mit dem Cmdlet "Get-AzStorageBlob " ab und übergibt dann das Ergebnis an das aktuelle Cmdlet. Das Cmdlet "Get-AzStorageContainer " ruft den Kopierstatus für den Blob "ContosoPlanning2015" in diesem Container ab.

Beispiel 4: Starten der Kopie und Pipeline zum Abrufen des Kopierstatus

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

$destBlob | Get-AzStorageBlobCopyState

Der erste Befehl startet das Kopieren des Blobs "ContosoPlanning2015" in "ContosoPlanning2015_copy", und gibt das Destiantion-BLOB-Objekt aus. Die zweite Befehlspipeline destiantion blob-Objekts zu Get-AzStorageBlobCopyState, um den Blobkopiezustand abzurufen.

Parameter

-Blob

Gibt den Namen eines Blobs an. Dieses Cmdlet ruft den Status des BLOB-Kopiervorgangs für das Azure Storage-Blob ab, das dieser Parameter angibt.

Typ:String
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ClientTimeoutPerRequest

Gibt das clientseitige Timeoutintervall in Sekunden für eine Serviceanfrage an. Wenn der vorherige Aufruf im angegebenen Intervall fehlschlägt, führt dieses Cmdlet die Anforderung erneut aus. Wenn dieses Cmdlet vor Ablauf des Intervalls keine erfolgreiche Antwort erhält, gibt dieses Cmdlet einen Fehler zurück.

Typ:Nullable<T>[Int32]
Aliase:ClientTimeoutPerRequestInSeconds
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-CloudBlob

Gibt ein CloudBlob-Objekt aus der Azure Storage Client-Bibliothek an. Verwenden Sie das Cmdlet "Get-AzStorageBlob", um ein CloudBlob-Objekt abzurufen.

Typ:CloudBlob
Aliase:ICloudBlob
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-CloudBlobContainer

Gibt ein CloudBlobContainer -Objekt aus der Azure Storage-Clientbibliothek an. Dieses Cmdlet ruft den Kopierstatus eines BLOB im Container ab, den dieser Parameter angibt. Verwenden Sie das Cmdlet "Get-AzStorageContainer", um ein CloudBlobContainer-Objekt abzurufen.

Typ:CloudBlobContainer
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-ConcurrentTaskCount

Gibt die maximalen gleichzeitigen Netzwerkanrufe an. Mit diesem Parameter können Sie die Parallelität einschränken, um die lokale CPU- und Bandbreitenauslastung zu drosseln, indem Sie die maximale Anzahl gleichzeitiger Netzwerkanrufe angeben. Der angegebene Wert ist eine absolute Anzahl und wird nicht mit der Kernanzahl multipliziert. Dieser Parameter kann dazu beitragen, Netzwerkverbindungsprobleme in Umgebungen mit geringer Bandbreite zu reduzieren, z. B. 100 Kilobit pro Sekunde. Der Standardwert ist 10.

Typ:Nullable<T>[Int32]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Container

Gibt den Namen eines Containers an. Dieses Cmdlet ruft den Kopierstatus für ein BLOB im Container ab, den dieser Parameter angibt.

Typ:String
Position:1
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Context

Gibt einen Azure-Speicherkontext an. Verwenden Sie zum Abrufen eines Speicherkontexts das Cmdlet New-AzStorageContext.

Typ:IStorageContext
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-DefaultProfile

Anmeldeinformationen, Konto, Mandant und Abonnement für die Kommunikation mit Azure

Typ:IAzureContextContainer
Aliase:AzureRmContext, AzureCredential
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ServerTimeoutPerRequest

Gibt das Dienstseitige Timeoutintervall in Sekunden für eine Anforderung an. Wenn das angegebene Intervall verstrichen ist, bevor der Dienst die Anforderung verarbeitet, gibt der Speicherdienst einen Fehler zurück.

Typ:Nullable<T>[Int32]
Aliase:ServerTimeoutPerRequestInSeconds
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-WaitForComplete

Gibt an, dass dieses Cmdlet auf den Abschluss der Kopie wartet. Wenn Sie diesen Parameter nicht angeben, gibt dieses Cmdlet ein Ergebnis sofort zurück.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

CloudBlob

CloudBlobContainer

IStorageContext

Ausgaben

CopyState