Partager via


Get-AzStorageFileCopyState

Obtient l’état d’une opération de copie.

Syntaxe

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

Description

L’applet de commande Get-AzStorageFileCopyState obtient l’état d’une opération de copie de fichier Stockage Azure. Il doit s’exécuter sur le fichier de destination de copie.

Exemples

Exemple 1 : Obtenir l’état de copie par nom de fichier

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

Cette commande obtient l’état de l’opération de copie pour un fichier portant le nom spécifié.

Exemple 2 : Démarrer la copie et le pipeline pour obtenir l’état de copie

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

$destfile | Get-AzStorageFileCopyState

La première commande démarre la copie du fichier « contosofile » vers « contosofile_copy » et génère l’objet de fichier detiantion. La deuxième commande pipeline l’objet de fichier detiantion vers Get-AzStorageFileCopyState, pour obtenir l’état de copie de fichier.

Paramètres

-ClientTimeoutPerRequest

Spécifie l’intervalle de délai d’attente côté client, en secondes, pour une demande de service. Si l’appel précédent échoue dans l’intervalle spécifié, cette applet de commande retente la requête. Si cette applet de commande ne reçoit pas de réponse réussie avant l’expiration de l’intervalle, cette applet de commande retourne une erreur.

Type:Nullable<T>[Int32]
Alias:ClientTimeoutPerRequestInSeconds
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ConcurrentTaskCount

Spécifie le nombre maximal d’appels réseau simultanés. Vous pouvez utiliser ce paramètre pour limiter l’accès concurrentiel pour limiter l’utilisation du processeur local et de la bande passante en spécifiant le nombre maximal d’appels réseau simultanés. La valeur spécifiée est un nombre absolu et n’est pas multipliée par le nombre de cœurs. Ce paramètre peut aider à réduire les problèmes de connexion réseau dans des environnements à faible bande passante, tels que 100 kilobits par seconde. La valeur par défaut est 10.

Type:Nullable<T>[Int32]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Context

Spécifie un contexte Stockage Azure. Pour obtenir un contexte, utilisez l’applet de commande New-AzStorageContext .

Type:IStorageContext
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-DefaultProfile

Informations d’identification, compte, locataire et abonnement utilisés pour la communication avec Azure.

Type:IAzureContextContainer
Alias:AzureRmContext, AzureCredential
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DisAllowTrailingDot

Interdire le point de fin (.) au répertoire de suffixe et aux noms de fichiers.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-File

Spécifie un objet CloudFile . Vous pouvez créer un fichier cloud ou en obtenir un à l’aide de l’applet de commande Get-AzStorageFile.

Type:CloudFile
Alias:CloudFile
Position:0
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-FilePath

Spécifie le chemin d’accès du fichier par rapport à un partage Stockage Azure.

Type:String
Position:1
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ServerTimeoutPerRequest

Spécifie la durée du délai d’attente pour la partie serveur d’une requête.

Type:Nullable<T>[Int32]
Alias:ServerTimeoutPerRequestInSeconds
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ShareFileClient

L’objet ShareFileClient a indiqué le fichier pour obtenir l’état de copie.

Type:ShareFileClient
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-ShareName

Spécifie le nom d’un partage.

Type:String
Position:0
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-WaitForComplete

Indique que cette applet de commande attend la fin de la copie. Si vous ne spécifiez pas ce paramètre, cette applet de commande retourne immédiatement un résultat.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Entrées

CloudFile

IStorageContext

Sorties

CopyState