Set-AzStorageFileContent
Charge le contenu d’un fichier.
Syntaxe
Set-AzStorageFileContent
[-ShareName] <String>
[-Source] <String>
[[-Path] <String>]
[-PassThru]
[-Force]
[-AsJob]
[-DisAllowTrailingDot]
[-Context <IStorageContext>]
[-ServerTimeoutPerRequest <Int32>]
[-ClientTimeoutPerRequest <Int32>]
[-DefaultProfile <IAzureContextContainer>]
[-ConcurrentTaskCount <Int32>]
[-WhatIf]
[-Confirm]
[-PreserveSMBAttribute]
[<CommonParameters>]
Set-AzStorageFileContent
[-Share] <CloudFileShare>
[-ShareClient <ShareClient>]
[-Source] <String>
[[-Path] <String>]
[-PassThru]
[-Force]
[-AsJob]
[-Context <IStorageContext>]
[-ServerTimeoutPerRequest <Int32>]
[-ClientTimeoutPerRequest <Int32>]
[-DefaultProfile <IAzureContextContainer>]
[-ConcurrentTaskCount <Int32>]
[-WhatIf]
[-Confirm]
[-PreserveSMBAttribute]
[<CommonParameters>]
Set-AzStorageFileContent
[-Directory] <CloudFileDirectory>
[-ShareDirectoryClient <ShareDirectoryClient>]
[-Source] <String>
[[-Path] <String>]
[-PassThru]
[-Force]
[-AsJob]
[-Context <IStorageContext>]
[-ServerTimeoutPerRequest <Int32>]
[-ClientTimeoutPerRequest <Int32>]
[-DefaultProfile <IAzureContextContainer>]
[-ConcurrentTaskCount <Int32>]
[-WhatIf]
[-Confirm]
[-PreserveSMBAttribute]
[<CommonParameters>]
Description
L’applet de commande Set-AzStorageFileContent charge le contenu d’un fichier dans un fichier sur un partage spécifié.
Exemples
Exemple 1 : Charger un fichier dans le dossier actif
Set-AzStorageFileContent -ShareName "ContosoShare06" -Source "DataFile37" -Path "ContosoWorkingFolder/CurrentDataFile"
Cette commande charge un fichier nommé DataFile37 dans le dossier actif sous la forme d’un fichier nommé CurrentDataFile dans le dossier nommé ContosoWorkingFolder.
Exemple 2 : Charger tous les fichiers dans le dossier actif
$CurrentFolder = (Get-Item .).FullName
$Container = Get-AzStorageShare -Name "ContosoShare06"
Get-ChildItem -Recurse | Where-Object { $_.GetType().Name -eq "FileInfo"} | ForEach-Object {
$path=$_.FullName.Substring($Currentfolder.Length+1).Replace("\","/")
Set-AzStorageFileContent -Share $Container -Source $_.FullName -Path $path -Force
}
Cet exemple utilise plusieurs applets de commande Windows PowerShell courantes et l’applet de commande actuelle pour charger tous les fichiers du dossier actif vers le dossier racine du conteneur ContosoShare06.
La première commande obtient le nom du dossier actif et la stocke dans la variable $CurrentFolder.
La deuxième commande utilise l’applet de commande Get-AzStorageShare pour obtenir le partage de fichiers nommé ContosoShare06, puis le stocke dans la variable $Container.
La commande finale obtient le contenu du dossier actif et passe chacun à l’applet de commande Where-Object à l’aide de l’opérateur de pipeline.
Cette applet de commande filtre les objets qui ne sont pas des fichiers, puis transmet les fichiers à l’applet de commande ForEach-Object.
Cette applet de commande exécute un bloc de script pour chaque fichier qui crée le chemin d’accès approprié, puis utilise l’applet de commande actuelle pour charger le fichier.
Le résultat a le même nom et la même position relative en ce qui concerne les autres fichiers que cet exemple charge.
Pour plus d’informations sur les blocs de script, tapez Get-Help about_Script_Blocks
.
Exemple 3 : Chargez un fichier local dans un fichier Azure et perservez les propriétés SMB du fichier local (Attributs de fichier, Heure de création de fichier, Heure d’écriture du dernier fichier) dans le fichier Azure.
Set-AzStorageFileContent -Source $localFilePath -ShareName sample -Path "dir1/file1" -PreserveSMBAttribute
Cet exemple charge un fichier local dans un fichier Azure et perserve les propriétés SMB du fichier local (Attributs de fichier, Heure de création de fichier, Heure de dernière écriture) dans le fichier Azure.
Paramètres
-AsJob
Exécutez l’applet de commande en arrière-plan.
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 |
-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 |
-Confirm
Vous demande une confirmation avant d’exécuter la commande cmdlet.
Type: | SwitchParameter |
Alias: | cf |
Position: | Named |
Valeur par défaut: | False |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-Context
Spécifie un contexte de stockage Azure. Pour obtenir un contexte de stockage, 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 |
-Directory
Spécifie un dossier en tant qu’objet CloudFileDirectory . Cette applet de commande charge le fichier dans le dossier spécifié par ce paramètre. Pour obtenir un répertoire, utilisez l’applet de commande New-AzStorageDirectory. Vous pouvez également utiliser l’applet de commande Get-AzStorageFile pour obtenir un répertoire.
Type: | CloudFileDirectory |
Alias: | CloudFileDirectory |
Position: | 0 |
Valeur par défaut: | None |
Obligatoire: | True |
Accepter l'entrée de pipeline: | True |
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 |
-Force
Indique que cette applet de commande remplace un fichier de stockage Azure existant.
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 |
-PassThru
Indique que cette applet de commande retourne l’objet AzureStorageFile qu’il crée ou charge.
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 |
-Path
Spécifie le chemin d’accès d’un fichier ou d’un dossier. Cette applet de commande charge le contenu dans le fichier spécifié par ce paramètre, ou dans un fichier du dossier spécifié par ce paramètre. Si vous spécifiez un dossier, cette applet de commande crée un fichier portant le même nom que le fichier source. Si vous spécifiez un chemin d’accès d’un fichier qui n’existe pas, cette applet de commande crée ce fichier et enregistre le contenu dans ce fichier. Si vous spécifiez un fichier qui existe déjà et que vous spécifiez le paramètre Force , cette applet de commande remplace le contenu du fichier. Si vous spécifiez un fichier qui existe déjà et que vous ne spécifiez pas Force, cette applet de commande n’apporte aucune modification et retourne une erreur. Si vous spécifiez un chemin d’accès d’un dossier qui n’existe pas, cette applet de commande n’apporte aucune modification et retourne une erreur.
Type: | String |
Position: | 2 |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-PreserveSMBAttribute
Conservez les propriétés SMB du fichier source (Attributs de fichier, Heure de création de fichier, Heure de la dernière écriture du fichier) dans le fichier de destination. Ce paramètre est disponible uniquement sur Windows.
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 |
-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 |
-Share
Spécifie un objet CloudFileShare . Cette applet de commande charge dans un fichier dans le partage de fichiers que ce paramètre spécifie. Pour obtenir un objet CloudFileShare , utilisez l’applet de commande Get-AzStorageShare. Cet objet contient le contexte de stockage. Si vous spécifiez ce paramètre, ne spécifiez pas le paramètre Context .
Type: | CloudFileShare |
Alias: | CloudFileShare |
Position: | 0 |
Valeur par défaut: | None |
Obligatoire: | True |
Accepter l'entrée de pipeline: | True |
Accepter les caractères génériques: | False |
-ShareClient
L’objet ShareClient indique le partage dans lequel le fichier serait chargé.
Type: | ShareClient |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | True |
Accepter les caractères génériques: | False |
-ShareDirectoryClient
L’objet CloudFileDirectory indique le répertoire cloud dans lequel le fichier serait chargé.
Type: | ShareDirectoryClient |
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 du partage de fichiers. Cette applet de commande charge dans un fichier dans le partage de fichiers que ce paramètre spécifie.
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 |
-Source
Spécifie le fichier source que cette applet de commande charge. Si vous spécifiez un fichier qui n’existe pas, cette applet de commande retourne une erreur.
Type: | String |
Alias: | FullName |
Position: | 1 |
Valeur par défaut: | None |
Obligatoire: | True |
Accepter l'entrée de pipeline: | True |
Accepter les caractères génériques: | False |
-WhatIf
Montre ce qui se passe en cas d’exécution de l’applet de commande. L’applet de commande n’est pas exécutée.
Type: | SwitchParameter |
Alias: | wi |
Position: | Named |
Valeur par défaut: | False |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |