New-Folder
This cmdlet creates a new folder on the specified location.
Syntax
Parameters
| Required | Parameter Name | Type | Position | Features | Description |
|---|---|---|---|---|---|
| required
|
Location | VIContainer | 1 |
|
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 |
|
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.FolderExamples
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.