New-MachineCatalog

Back to overview

NAME
    New-MachineCatalog
    
SYNOPSIS
    Creates a new catalog
    
SYNTAX
    New-MachineCatalog -Name <String> [-Description <String>] -AllocationType <String> -ProvisioningType <String> -PersistUserChanges <String> -SessionSupport <String> 
    [-MachinesArePhysical <Boolean>] [<CommonParameters>]
    
    New-MachineCatalog -Name <String> [-Description <String>] -AllocationType <String> -ProvisioningType <String> -PersistUserChanges <String> -SessionSupport <String> 
    -MasterImageVM <String> -CpuCount <Int32> -MemoryMB <Int32> -CleanOnBoot <Boolean> [-UsePersonalVDiskStorage <Boolean>] -NamingScheme <String> -NamingSchemeType 
    <String> -OU <String> -Domain <String> -HostingUnitName <String> [<CommonParameters>]
    
    New-MachineCatalog -CatalogParams <PSObject[]> [-Suffix <String>] [<CommonParameters>]
    
    
PARAMETERS
    -Name <String>
        Name of the new catalog
        
        Required?                    true
        Position?                    named
        Default value                
        Accept pipeline input?       false
        Accept wildcard characters?  false
        
    -Description <String>
        Description of the new catalog
        
        Required?                    false
        Position?                    named
        Default value                
        Accept pipeline input?       false
        Accept wildcard characters?  false
        
    -AllocationType <String>
        Allocation type of the catalog
        
        Required?                    true
        Position?                    named
        Default value                
        Accept pipeline input?       false
        Accept wildcard characters?  false
        
    -ProvisioningType <String>
        Provisioning type of the catalog
        
        Required?                    true
        Position?                    named
        Default value                
        Accept pipeline input?       false
        Accept wildcard characters?  false
        
    -PersistUserChanges <String>
        Whether and how to persist user changes
        
        Required?                    true
        Position?                    named
        Default value                
        Accept pipeline input?       false
        Accept wildcard characters?  false
        
    -SessionSupport <String>
        How many sessions are permitted
        
        Required?                    true
        Position?                    named
        Default value                
        Accept pipeline input?       false
        Accept wildcard characters?  false
        
    -MachinesArePhysical <Boolean>
        
        Required?                    false
        Position?                    named
        Default value                False
        Accept pipeline input?       false
        Accept wildcard characters?  false
        
    -MasterImageVM <String>
        Path to master image
        
        Required?                    true
        Position?                    named
        Default value                
        Accept pipeline input?       false
        Accept wildcard characters?  false
        
    -CpuCount <Int32>
        Number of vCPUs for virtual machines
        
        Required?                    true
        Position?                    named
        Default value                0
        Accept pipeline input?       false
        Accept wildcard characters?  false
        
    -MemoryMB <Int32>
        Memory in MB for virtual machines
        
        Required?                    true
        Position?                    named
        Default value                0
        Accept pipeline input?       false
        Accept wildcard characters?  false
        
    -CleanOnBoot <Boolean>
        Whether to discard changes on boot
        
        Required?                    true
        Position?                    named
        Default value                False
        Accept pipeline input?       false
        Accept wildcard characters?  false
        
    -UsePersonalVDiskStorage <Boolean>
        Whether to use Personal vDisk
        
        Required?                    false
        Position?                    named
        Default value                False
        Accept pipeline input?       false
        Accept wildcard characters?  false
        
    -NamingScheme <String>
        Naming scheme for new virtual machines
        
        Required?                    true
        Position?                    named
        Default value                
        Accept pipeline input?       false
        Accept wildcard characters?  false
        
    -NamingSchemeType <String>
        Type of naming scheme
        
        Required?                    true
        Position?                    named
        Default value                
        Accept pipeline input?       false
        Accept wildcard characters?  false
        
    -OU <String>
        Organizational unit for new virtual machines
        
        Required?                    true
        Position?                    named
        Default value                
        Accept pipeline input?       false
        Accept wildcard characters?  false
        
    -Domain <String>
        Domain for new virtual machines
        
        Required?                    true
        Position?                    named
        Default value                
        Accept pipeline input?       false
        Accept wildcard characters?  false
        
    -HostingUnitName <String>
        Hosting connection to use
        
        Required?                    true
        Position?                    named
        Default value                
        Accept pipeline input?       false
        Accept wildcard characters?  false
        
    -CatalogParams <PSObject[]>
        Hash of settings for new broker catalog
        
        Required?                    true
        Position?                    named
        Default value                
        Accept pipeline input?       true (ByValue)
        Accept wildcard characters?  false
        
    -Suffix <String>
        Suffix to be added to name of the catalog
        
        Required?                    false
        Position?                    named
        Default value                
        Accept pipeline input?       false
        Accept wildcard characters?  false
        
    <CommonParameters>
        This cmdlet supports the common parameters: Verbose, Debug,
        ErrorAction, ErrorVariable, WarningAction, WarningVariable,
        OutBuffer, PipelineVariable, and OutVariable. For more information, see 
        about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216). 
    
    
NOTES
    
    
        Thanks to Aaron Parker (@stealthpuppy) for the original code (http://stealthpuppy.com/xendesktop-mcs-machine-catalog-powershell/)
    
    -------------------------- EXAMPLE 1 --------------------------
    
    C:\PS>Get-BrokerCatalog | ConvertFrom-MachineCatalog | New-MachineCatalog -Suffix '-test'
    
    
   
RELATED LINKS
    ConvertFrom-MachineCatalog
    Export-MachineCatalog
    Sync-MachineCatalog
    Update-DeliveryGroup