New-ProvVMConfiguration
Creates a new configuration for a provisioned vm
Syntax
New-ProvVMConfiguration
[-CpuCount <Int32>]
[-MemoryInMB <Int32>]
[-CustomProperties <String>]
[-MachineProfile <String>]
[-NetworkMapping <Hashtable>]
[-WriteBackCacheDiskSize <Int32>]
[-WriteBackCacheMemorySize <Int32>]
-ADAccountSid <String>
-ProvisioningSchemeUid <Guid>
[-ConfigurationInfo <String>]
[-RemoveCustomizations]
[-LoggingId <Guid>]
[<CitrixCommonParameters>]
[<CommonParameters>]
New-ProvVMConfiguration
[-CustomProperties <String>]
-ServiceOffering <String>
[-MachineProfile <String>]
[-NetworkMapping <Hashtable>]
[-WriteBackCacheDiskSize <Int32>]
[-WriteBackCacheMemorySize <Int32>]
-ADAccountSid <String>
-ProvisioningSchemeUid <Guid>
[-ConfigurationInfo <String>]
[-RemoveCustomizations]
[-LoggingId <Guid>]
[<CitrixCommonParameters>]
[<CommonParameters>]
New-ProvVMConfiguration
[-CpuCount <Int32>]
[-MemoryInMB <Int32>]
[-CustomProperties <String>]
[-MachineProfile <String>]
[-NetworkMapping <Hashtable>]
[-WriteBackCacheDiskSize <Int32>]
[-WriteBackCacheMemorySize <Int32>]
-ADAccountSid <String>
-ProvisioningSchemeName <String>
[-ConfigurationInfo <String>]
[-RemoveCustomizations]
[-LoggingId <Guid>]
[<CitrixCommonParameters>]
[<CommonParameters>]
New-ProvVMConfiguration
[-CustomProperties <String>]
-ServiceOffering <String>
[-MachineProfile <String>]
[-NetworkMapping <Hashtable>]
[-WriteBackCacheDiskSize <Int32>]
[-WriteBackCacheMemorySize <Int32>]
-ADAccountSid <String>
-ProvisioningSchemeName <String>
[-ConfigurationInfo <String>]
[-RemoveCustomizations]
[-LoggingId <Guid>]
[<CitrixCommonParameters>]
[<CommonParameters>]
Description
Creates a new configuration for a provisioned vm as specified by the user to be used for hardware update
Examples
Parameters
-ProvisioningSchemeUid
Indicates the Uid of the provisioningscheme
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ProvisioningSchemeName
Indicates the Name of the provisioningscheme
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ADAccountSid
Indicates the Sid of the virtual machine
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ServiceOffering
The Service Offering to use when creating VMs in Cloud Hypervisors, replacing the present one. Cannot be used alongside either VMCpuCount or VMMemoryMB.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-CpuCount
The number of processors that will be used to create VMs from the provisioning scheme, replacing the present one.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-MemoryInMB
The amount of memory that will be used to created VMs from the provisioning scheme in MB, replacing the present one
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-CustomProperties
The properties of the provisioning scheme that are specific to the target hosting infrastructure. See about_Prov_CustomProperties for more information. If a property name already exists its value is updated; otherwise it is added
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-MachineProfile
Defines the inventory path to the source VM used by the provisioning scheme as a template. This profile identifies the properties for the VMs created from the scheme. The VM must be in the hosting unit that HostingUnitName or HostingUnitUid refers to. If any properties are present in the MachineProfile but not the CustomProperties, values from the template will be written back to the CustomProperties.See about_Prov_MachineProfile for more details.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-NetworkMapping
Specifies how the attached NICs are mapped to networks. If this parameter is omitted, the current NICs setting of the provisioning scheme is not updated; otherwise the NICs setting is updated, and new machines will be created with the number of NICs specified in the map, with each NIC attached to the specified network. Cannot set to an empty value.
| Type: | Hashtable |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WriteBackCacheDiskSize
Specifies the size in Gigabytes of the disk to use as a Write Back Cache when UseWriteBackCache is set during the Provisioning Scheme creation. This parameter can only be set or modified if the Provisioning Scheme was previously created with UseWriteBackCache. This parameter only applies to newly created VMs and does not affect VMs which have already been created from the Provisioning Scheme.Setting this parameter to 0 is not allowed.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WriteBackCacheMemorySize
Specifies the size in Megabytes of the memory to use as a Write Back Cache when UseWriteBackCache is set during the Provisioning Scheme creation. This parameter can only be set or modified if the Provisioning Scheme was previously created with UseWriteBackCache. This parameter only applies to newly created VMs and does not affect VMs which have already been created from the Provisioning Scheme
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ConfigurationInfo
This parameter is for a brief information or details on the personalization
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RemoveCustomizations
This parameter is to create version without any personalization
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-LoggingId
Specifies the identifier of the high-level operation this cmdlet call forms a part of. Citrix Studio and Director typically create high-level operations. PowerShell scripts can also wrap a series of cmdlet calls in a high-level operation by way of the Start-LogHighLevelOperation and Stop-LogHighLevelOperation cmdlets.
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
CitrixCommonParameters
This cmdlet supports the common Citrix parameters: -AdminAddress, -AdminClientIP, -BearerToken, -TraceParent, -TraceState and -VirtualSiteId. For more information, see about_CitrixCommonParameters.
CommonParameters
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.
Inputs
None
You can't pipe objects to this cmdlet.
Outputs
None
By default, this cmdlet returns no output.