El recurso de archivo en la configuración de estado deseado (DSC) de Windows PowerShell proporciona un mecanismo para administrar archivos y carpetas en el nodo de destino. DestinationPath y SourcePath deben ser accesibles para el nodo de destino.
Esta documentación de este recurso de DSC cubre la versión que se incluye con PowerShell antes de la versión 7.2. El módulo PSDscResources contiene nuevos y actualizados que son compatibles oficialmente con Microsoft. El módulo PSDscResources está disponible en la Galería de PowerShell.
Para obtener más información y documentación actualizada, consulte el LÉAME en el repositorio de GitHub.
Sintaxis:
File [string] #ResourceName
{
DestinationPath = [string]
[ Attributes = [string[]] { Archive | Hidden | ReadOnly | System }]
[ Checksum = [string] { CreatedDate | ModifiedDate | SHA-1 | SHA-256 | SHA-512 } ]
[ Contents = [string] ]
[ Credential = [PSCredential] ]
[ Force = [bool] ]
[ Recurse = [bool] ]
[ SourcePath = [string] ]
[ Type = [string] { Directory | File } ]
[ MatchSource = [bool] ]
[ DependsOn = [string[]] ]
[ Ensure = [string] { Absent | Present } ]
[ PsDscRunAsCredential = [PSCredential] ]
}
Información adicional:
- Cuando solo especifica DestinationPath, el recurso garantiza que la ruta existe si está presente o no existe si está ausente.
- Cuando especifica SourcePath y DestinationPath con un valor de tipo de directorio, el recurso copia el directorio de origen en la ruta de destino. Las propiedades Recurse, Force y MatchSource cambian el tipo de operación de copia realizada, mientras que Credential determina qué cuenta usar para acceder al directorio de origen.
- Si no establece la propiedad Recurse en $true al copiar un directorio, no se copiará ninguno de los contenidos del directorio existente. Solo se copiará el directorio especificado.
- Si especificó un valor de Solo lectura para la propiedad Atributos junto con DestinationPath, Asegúrese de que presente crearía la ruta especificada, mientras que Contenido establecería el contenido del archivo. Una configuración de Asegurar ausencia ignoraría la propiedad Atributos por completo y eliminaría cualquier archivo en la ruta especificada.
Espero que os resulte útil.
Un saludo