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 |