FlattenFolders

1.1.2

FlattenFolders.dll-Help.xml

<?xml version="1.0" encoding="utf-8" ?>
<helpItems xmlns="http://msh" schema="maml">
<command:command
  xmlns:maml="http://schemas.microsoft.com/maml/2004/10"
  xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10"
  xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10"
  xmlns:MSHelp="http://msdn.microsoft.com/mshelp">
  <command:details>
    <command:name>Invoke-FlattenFolders</command:name>
    <command:verb>Invoke</command:verb>
    <command:noun>FlattenFolders</command:noun>
    <maml:description>
      <maml:para>
        Moves files from all sub-directories to the parent directory and optionally delete sub-directories.
      </maml:para>
    </maml:description>
  </command:details>
  <maml:description>
    <maml:para>
      Moves files from all sub-directories to the parent directory. If files with duplicate names are found then their file name will have a guid appended to make them unique.
    </maml:para>
    <maml:para>
      Unless the Force parameter is used there will be a prompt for confirmation before both the renaming of any files (if required) and the moving of any files.
    </maml:para>
    <maml:para>
      Can be run against:
    </maml:para>
    <maml:para>
      &gt; a single directory
    </maml:para>
    <maml:para>
      &gt; a collection of directories piped into the module.
    </maml:para>
  </maml:description>
  <command:parameters>
    <command:parameter required="false" pipelineInput="false" variableLength="true" position="0" aliases="D">
      <maml:name>Directory</maml:name>
      <maml:description>
        <maml:para>
          The parent directory where files from all sub-directories will be moved. If neither this nor the Directories parameter are set then the current location will be used.
        </maml:para>
      </maml:description>
      <command:parameterValue required="false" variableLength="true">String</command:parameterValue>
      <dev:type>String</dev:type>
      <dev:defaultvalue>Current directory</dev:defaultvalue>
    </command:parameter>
    <command:parameter required="false" pipelineInput="true" variableLength="true" aliases="none">
      <maml:name>Directories</maml:name>
      <maml:description>
        <maml:para>
          A collection of parent directories where files from all sub-directories will be moved. If neither this nor the Directory parameter are set then the current location will be used.
        </maml:para>
      </maml:description>
      <command:parameterValue required="false" variableLength="true">List&lt;String&gt;</command:parameterValue>
      <dev:type>List&lt;String&gt;</dev:type>
      <dev:defaultValue>None</dev:defaultValue>
    </command:parameter>
    <command:parameter required="false" pipelineInput="false" variableLength="false" aliases="F">
      <maml:name>Force</maml:name>
      <maml:description>
        <maml:para>
          If supplied this bypasses the confirmation prompt before both renaming and moving files.
        </maml:para>
      </maml:description>
      <command:parameterValue required="false" variableLength="false">SwitchParameter</command:parameterValue>
      <dev:type>SwitchParameter</dev:type>
      <dev:defaultValue>None</dev:defaultValue>
    </command:parameter>
    <command:parameter required="false" pipelineInput="false" variableLength="false" aliases="DS">
      <maml:name>DeleteSubDirectories</maml:name>
      <maml:description>
        <maml:para>
          If supplied all subdirectories will be deleted once all files have been moved.
        </maml:para>
      </maml:description>
      <command:parameterValue required="false" variableLength="false">SwitchParameter</command:parameterValue>
      <dev:type>SwitchParameter</dev:type>
      <dev:defaultValue>None</dev:defaultValue>
    </command:parameter>
  </command:parameters>
  <command:examples>
    <command:example>
      <maml:title>Example 1: No parameters</maml:title>
      <dev:code>PS C:\&gt; Invoke-FlattenFolder</dev:code>
      <dev:remarks>
        <maml:para>
          All files in all sub-directories in the current location (C:\) will be moved to the current location (C:\) with a confirmation prompt before moving.
        </maml:para>
      </dev:remarks>
    </command:example>
    <command:example>
      <maml:title>Example 2: Using the Force switch</maml:title>
      <dev:code>PS C:\&gt; Invoke-FlattenFolder -Directory "C:\Videos" -Force</dev:code>
      <dev:remarks>
        <maml:para>
          All files in all sub-directories in C:\Videos\ will be moved to C:\Videos\ without a confirmation prompt.
        </maml:para>
      </dev:remarks>
    </command:example>
    <command:example>
      <maml:title>Example 3: Using the DeleteSubDirectories switch</maml:title>
      <dev:code>PS C:\&gt; Invoke-FlattenFolder -Directory "C:\Videos" -Force -DeleteSubDirectories</dev:code>
      <dev:remarks>
        <maml:para>
          All files in all sub-directories in C:\Videos\ will be moved to C:\Videos\ without a confirmation prompt and all sub-directories will be deleted once the files have been moved.
        </maml:para>
      </dev:remarks>
    </command:example>
    <command:example>
      <maml:title>Example 4: Piping input</maml:title>
      <dev:code>PS C:\&gt; "C:\Videos\","C:\Music\" | Invoke-FlattenFolder</dev:code>
      <dev:remarks>
        <maml:para>
          All files in all sub-directories in the piped array of directories (C:\Videos\ and C:\Music\) will be moved to their respective parents with a confirmation prompt before moving.
        </maml:para>
      </dev:remarks>
    </command:example>
  </command:examples>
  <maml:relatedLinks>
    <maml:navigationLink>
      <maml:linkText>https://github.com/trossr32/ps-flatten-folders</maml:linkText>
    </maml:navigationLink>
  </maml:relatedLinks>
</command:command>
</helpItems>