Freigeben über


Get-AzStorageFileCopyState

Ruft den Status eines Kopiervorgangs ab.

Syntax

ShareName

Get-AzStorageFileCopyState
    [-ShareName] <String>
    [-FilePath] <String>
    [-WaitForComplete]
    [-DisAllowTrailingDot]
    [-Context <IStorageContext>]
    [-ServerTimeoutPerRequest <Int32>]
    [-ClientTimeoutPerRequest <Int32>]
    [-DefaultProfile <IAzureContextContainer>]
    [-ConcurrentTaskCount <Int32>]
    [<CommonParameters>]

File

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

Beschreibung

Das Cmdlet Get-AzStorageFileCopyState ruft den Status eines Azure Storage-Dateikopievorgangs ab. Sie sollte in der Kopierzieldatei ausgeführt werden.

Beispiele

Beispiel 1: Abrufen des Kopierstatus anhand des Dateinamens

Get-AzStorageFileCopyState -ShareName "ContosoShare" -FilePath "ContosoFile"

Dieser Befehl ruft den Status des Kopiervorgangs für eine Datei mit dem angegebenen Namen ab.

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

$destfile = Start-AzStorageFileCopy -SrcShareName "contososhare" -SrcFilePath "contosofile" -DestShareName "contososhare2" -destfilepath "contosofile_copy"

$destfile | Get-AzStorageFileCopyState

Der erste Befehl startet die Kopie der Datei "contosofile" in "contosofile_copy", und gibt das Zieldateiobjekt aus. Die zweite Befehlspipeline des Zieldateiobjekts zu Get-AzStorageFileCopyState, um den Dateikopiezustand abzurufen.

Parameter

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

Parametereigenschaften

Typ:

Nullable<T>[Int32]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:ClientTimeoutPerRequestInSeconds

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten: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.

Parametereigenschaften

Typ:

Nullable<T>[Int32]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Context

Gibt einen Azure Storage-Kontext an. Verwenden Sie zum Abrufen eines Kontexts das Cmdlet New-AzStorageContext .

Parametereigenschaften

Typ:IStorageContext
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-DefaultProfile

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

Parametereigenschaften

Typ:IAzureContextContainer
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:AzureRmContext, AzureCredential

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-DisAllowTrailingDot

Nicht zulassen, dass nachgestellter Punkt (.) verzeichnis- und Dateinamen suffixiert werden.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

ShareName
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-FilePath

Gibt den Pfad der Datei relativ zu einer Azure Storage-Freigabe an.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

ShareName
Position:1
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-ServerTimeoutPerRequest

Gibt die Länge des Timeoutzeitraums für den Serverteil einer Anforderung an.

Parametereigenschaften

Typ:

Nullable<T>[Int32]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:ServerTimeoutPerRequestInSeconds

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-ShareFileClient

Das ShareFileClient-Objekt hat die Datei zum Abrufen des Kopierstatus angegeben.

Parametereigenschaften

Typ:ShareFileClient
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

File
Position:0
Obligatorisch:True
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-ShareName

Gibt den Namen einer Freigabe an.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

ShareName
Position:0
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten: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.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.

Eingaben

ShareFileClient

IStorageContext

Ausgaben

Microsoft.WindowsAzure.Commands.Storage.Common.PSCopyState