New-Folder Command | Vmware PowerCLI Reference

New-Folder

This cmdlet creates a new folder on the specified location.

Syntax

New-Folder
[ -Location ] < VIContainer >
-Name < String >
[-ProgressAction < ActionPreference > ]
[-Server < VIServer[] > ]
[CommonParameters]

Parameters

Required Parameter Name Type Position Features Description
required
Location VIContainer 1
  • pipeline
  • wildcards
Specifies a container object (folder or datacenter) where you want to place the new folder. If a datacenter is specified for the Location parameter, then the folder is created in its "hostFolder" folder and contains hosts and clusters. The "hostFolder" is a system folder and is guaranteed to exist.
required
Name String named
Specifies a name for the new folder.
optional ProgressAction ActionPreference named
optional Server VIServer[] named
  • wildcards
Specifies the vCenter Server systems on which you want to run the cmdlet. If no value is provided or $null value is passed to this parameter, the command runs on the default servers. For more information about default servers, see the description of Connect-VIServer.

Output

VMware.VimAutomation.ViCore.Types.V1.Inventory.Folder

Examples

Example 1

New-Folder -Name "Folder1" -Location (Get-Datacenter)[0]

Creates a new folder in a datacenter root.

Example 2

Get-Folder | Select -First 1 | New-Folder -Name "Folder2"

Creates a nested folder by using a pipeline command.

Example 3

New-Folder -Name "FirstLevelFolder1" -Location (Get-Folder vm)

Creates a new folder in the root vSphere virtual machine folder.

Related Commands

Folder

This cmdlet retrieves the folders available on a vCenter Server system.

This cmdlet moves a vCenter Server folder from one location to another.

This cmdlet creates a new folder on a vCenter Server system.

This cmdlet removes the specified folders from their locations.

This cmdlet modifies the properties of the specified folder.