Export (0) Print
Expand All
Collapse the table of content
Expand the table of content
Expand Minimize

New-CMStoragefolder

New-CMStoragefolder

Creates a new storage folder in Configuration Manager.

Syntax

Parameter Set: NewStoragefolder
New-CMStoragefolder -MaximumClientNumber <Int32> -MinimumFreeSpace <Int32> -SpaceUnit <MinSpaceType> {Gigabyte | Megabyte | Percent} -StorageFolderName <String> [-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. Acceptable values for this parameter are numbers between 1 and 99999.


Aliases

none

Required?

true

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. Acceptable values for this parameter are numbers between 1 - 99999 when specifying a byte value, or numbers between 1 - 100 when specifying a percentage.


Aliases

none

Required?

true

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?

true

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 running the cmdlet.


Required?

false

Position?

named

Default Value

false

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.


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 (http://go.microsoft.com/fwlink/p/?LinkID=113216).

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

Community Additions

ADD
Show:
© 2015 Microsoft