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 (https://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"