Set-AzStorageFileContent
Carga el contenido de un archivo.
Sintaxis
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
El cmdlet Set-AzStorageFileContent carga el contenido de un archivo en un archivo de un recurso compartido especificado.
Ejemplos
Ejemplo 1: Carga de un archivo en la carpeta actual
Set-AzStorageFileContent -ShareName "ContosoShare06" -Source "DataFile37" -Path "ContosoWorkingFolder/CurrentDataFile"Este comando carga un archivo denominado DataFile37 en la carpeta actual como un archivo denominado CurrentDataFile en la carpeta denominada ContosoWorkingFolder.
Ejemplo 2: Cargar todos los archivos de la carpeta actual
$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
}En este ejemplo se usan varios cmdlets comunes de Windows PowerShell y el cmdlet actual para cargar todos los archivos de la carpeta actual en la carpeta raíz del contenedor ContosoShare06.
El primer comando obtiene el nombre de la carpeta actual y lo almacena en la variable $CurrentFolder.
El segundo comando usa el cmdlet Get-AzStorageShare para obtener el recurso compartido de archivos denominado ContosoShare06 y, a continuación, lo almacena en la variable $Container.
El comando final obtiene el contenido de la carpeta actual y pasa cada uno al cmdlet Where-Object mediante el operador de canalización.
Ese cmdlet filtra los objetos que no son archivos y, a continuación, pasa los archivos al cmdlet ForEach-Object.
Ese cmdlet ejecuta un bloque de script para cada archivo que crea la ruta de acceso adecuada para él y, a continuación, usa el cmdlet actual para cargar el archivo.
El resultado tiene el mismo nombre y la misma posición relativa con respecto a los demás archivos que carga este ejemplo.
Para obtener más información sobre los bloques de script, escriba Get-Help about_Script_Blocks.
Ejemplo 3: Cargar un archivo local en un archivo de Azure y conservar las propiedades de SMB de archivo local (File Attributtes, File Creation Time, File Last Write Time) en el archivo de Azure.
Set-AzStorageFileContent -Source $localFilePath -ShareName sample -Path "dir1/file1" -PreserveSMBAttributeEn este ejemplo se carga un archivo local en un archivo de Azure y se conservan las propiedades de SMB de archivo local (File Attributtes, File Creation Time, File Last Write Time) en el archivo de Azure.
Parámetros
-AsJob
Ejecute el cmdlet en segundo plano.
| Tipo: | SwitchParameter |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-ClientTimeoutPerRequest
Especifica el intervalo de tiempo de espera del lado cliente, en segundos, para una solicitud de servicio. Si se produce un error en la llamada anterior en el intervalo especificado, este cmdlet reintenta la solicitud. Si este cmdlet no recibe una respuesta correcta antes de que transcurre el intervalo, este cmdlet devuelve un error.
| Tipo: | Nullable<T>[Int32] |
| Alias: | ClientTimeoutPerRequestInSeconds |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-ConcurrentTaskCount
Especifica el número máximo de llamadas de red simultáneas. Puede usar este parámetro para limitar la simultaneidad para limitar el uso de ancho de banda y CPU local especificando el número máximo de llamadas de red simultáneas. El valor especificado es un recuento absoluto y no se multiplica por el recuento de núcleos. Este parámetro puede ayudar a reducir los problemas de conexión de red en entornos de ancho de banda bajo, como 100 kilobits por segundo. El valor predeterminado es 10.
| Tipo: | Nullable<T>[Int32] |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-Confirm
Le solicita su confirmación antes de ejecutar el cmdlet.
| Tipo: | SwitchParameter |
| Alias: | cf |
| Posición: | Named |
| Valor predeterminado: | False |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-Context
Especifica un contexto de almacenamiento de Azure. Para obtener un contexto de almacenamiento, use el cmdlet New-AzStorageContext .
| Tipo: | IStorageContext |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | True |
| Aceptar caracteres comodín: | False |
-DefaultProfile
Credenciales, cuenta, inquilino y suscripción usados para la comunicación con Azure.
| Tipo: | IAzureContextContainer |
| Alias: | AzureRmContext, AzureCredential |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-Directory
Especifica una carpeta como un objeto CloudFileDirectory . Este cmdlet carga el archivo en la carpeta que especifica este parámetro. Para obtener un directorio, use el cmdlet New-AzStorageDirectory. También puede usar el cmdlet Get-AzStorageFile para obtener un directorio.
| Tipo: | CloudFileDirectory |
| Alias: | CloudFileDirectory |
| Posición: | 0 |
| Valor predeterminado: | None |
| Requerido: | True |
| Aceptar entrada de canalización: | True |
| Aceptar caracteres comodín: | False |
-DisAllowTrailingDot
No permitir el punto final (.) al directorio de sufijo y los nombres de archivo.
| Tipo: | SwitchParameter |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-Force
Indica que este cmdlet sobrescribe un archivo de Azure Storage existente.
| Tipo: | SwitchParameter |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-PassThru
Indica que este cmdlet devuelve el objeto AzureStorageFile que crea o carga.
| Tipo: | SwitchParameter |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-Path
Especifica la ruta de acceso de un archivo o carpeta. Este cmdlet carga el contenido en el archivo que especifica este parámetro o en un archivo de la carpeta que especifica este parámetro. Si especifica una carpeta, este cmdlet crea un archivo que tiene el mismo nombre que el archivo de origen. Si especifica una ruta de acceso de un archivo que no existe, este cmdlet crea ese archivo y guarda el contenido en ese archivo. Si especifica un archivo que ya existe y especifica el parámetro Force , este cmdlet sobrescribe el contenido del archivo. Si especifica un archivo que ya existe y no especifica Force, este cmdlet no realiza ningún cambio y devuelve un error. Si especifica una ruta de acceso de una carpeta que no existe, este cmdlet no realiza ningún cambio y devuelve un error.
| Tipo: | String |
| Posición: | 2 |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-PreserveSMBAttribute
Mantenga las propiedades SMB de archivo de origen (File Attributtes, File Creation Time, File Last Write Time) en el archivo de destino. Este parámetro solo está disponible en Windows.
| Tipo: | SwitchParameter |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-ServerTimeoutPerRequest
Especifica el período de tiempo de espera para la parte del servidor de una solicitud.
| Tipo: | Nullable<T>[Int32] |
| Alias: | ServerTimeoutPerRequestInSeconds |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-Share
Especifica un objeto CloudFileShare . Este cmdlet carga en un archivo del recurso compartido de archivos que especifica este parámetro. Para obtener un objeto CloudFileShare , use el cmdlet Get-AzStorageShare. Este objeto contiene el contexto de almacenamiento. Si especifica este parámetro, no especifique el parámetro Context .
| Tipo: | CloudFileShare |
| Alias: | CloudFileShare |
| Posición: | 0 |
| Valor predeterminado: | None |
| Requerido: | True |
| Aceptar entrada de canalización: | True |
| Aceptar caracteres comodín: | False |
-ShareClient
El objeto ShareClient indicó el recurso compartido en el que se cargaría el archivo.
| Tipo: | ShareClient |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | True |
| Aceptar caracteres comodín: | False |
-ShareDirectoryClient
El objeto CloudFileDirectory indicó el directorio en la nube donde se cargaría el archivo.
| Tipo: | ShareDirectoryClient |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | True |
| Aceptar caracteres comodín: | False |
-ShareName
Especifica el nombre del recurso compartido de archivos. Este cmdlet carga en un archivo del recurso compartido de archivos que especifica este parámetro.
| Tipo: | String |
| Posición: | 0 |
| Valor predeterminado: | None |
| Requerido: | True |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-Source
Especifica el archivo de origen que carga este cmdlet. Si especifica un archivo que no existe, este cmdlet devuelve un error.
| Tipo: | String |
| Alias: | FullName |
| Posición: | 1 |
| Valor predeterminado: | None |
| Requerido: | True |
| Aceptar entrada de canalización: | True |
| Aceptar caracteres comodín: | False |
-WhatIf
Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.
| Tipo: | SwitchParameter |
| Alias: | wi |
| Posición: | Named |
| Valor predeterminado: | False |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
