Export (0) Print
Expand All
Expand Minimize

New-CMStoragefolder

Updated: February 7, 2014

Applies To: System Center 2012 R2 Configuration Manager

New-CMStoragefolder

Creates a new storage folder in Configuration Manager.

Syntax

Parameter Set: NewStorageFolder
New-CMStoragefolder -StorageFolderName <String> [-MaximumClientNumber <Int32> ] [-MinimumFreeSpace <Int32> ] [-SpaceUnit <MinSpaceType> {Gigabyte | Megabyte | Percent} ] [-Confirm] [-WhatIf] [ <CommonParameters>]




Detailed Description

The New-CMStoragefolder cmdlet creates a new storage folder to store user migration data in Microsoft System Center 2012 Configuration Manager.

A storage folder identifies a location on a state migration point site system to store user migration data. Use this cmdlet in conjunction with the Add-CMStateMigrationPoint cmdlet to create a new state migration point with storage folders.

Parameters

-MaximumClientNumber<Int32>

Specifies the maximum number of clients that the storage folder can hold. The storage folder contains user state migration data in Configuration Manager. Valid values are: numbers between 1 and 99999.


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-MinimumFreeSpace<Int32>

Specifies the minimum amount of free space for storage of user state migration data. Valid values are: numbers between 1 - 99999 when specifying a byte value, or numbers between 1 - 100 when specifying a percentage.


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-SpaceUnit<MinSpaceType>

Specifies the storage units for the MinimumFreeSpace parameter.


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-StorageFolderName<String>

Specifies a local path for the storage folder. The associated state migration point site system role in Configuration Manager uses this path.


Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-Confirm

Prompts you for confirmation before executing the command.


Required?

false

Position?

named

Default Value

false

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-WhatIf

Describes what would happen if you executed the command without actually executing the command.


Required?

false

Position?

named

Default Value

false

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

<CommonParameters>

This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see about_CommonParameters.

Inputs

The input type is the type of the objects that you can pipe to the cmdlet.

Outputs

The output type is the type of the objects that the cmdlet emits.

Examples

Example 1: Create a new storage folder

This command creates a new storage folder for migration data by using the maximum number of clients, minimum free space, and storage folder path parameters.


PS C:\> New-CMStoragefolder -MaximumClientNumber 80 -MinimumFreeSpace 10 -SpaceUnit Megabyte -StorageFolderName "D:\Contoso-Mobile-Users"
 
Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft