Partager via


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

Entrées

CloudFileShare

CloudFileDirectory

String

IStorageContext

Sorties

AzureStorageFile