Error: "XDDS:16489564" When Creating Machine Catalog

Error: "XDDS:16489564" When Creating Machine Catalog

book

Article ID: CTX202104

calendar_today

Updated On:

Description

Failure occurs when trying to create a machine catalog with error Id: XDDS:16489564 and error message "Illegal characters in path."

Exception:
    Citrix.Console.Models.Exceptions.ScriptException Unexpected error. Contact Citrix Support.
       at Citrix.Console.PowerShellInteraction.CmdletExecutionMethods.CreateException[T](ICommonLog logger, ExecutionResults`1 results, ICmdletExecutionHost host)
       at Citrix.Console.PowerShellInteraction.CmdletExecutionMethods.Execute[T](ISdkCmdlet`1 sdkCmd, ICmdletExecutionHost host, Boolean allowFailover)
       at Citrix.Console.PowerShellSdk.ProvisioningSchemeService.BackgroundTasks.ProvisioningSchemeCreationTask.StartProvisioningAction()
       at Citrix.Console.PowerShellSdk.ProvisioningSchemeService.BackgroundTasks.ProvisioningSchemeCreationTask.RunTask()
       at Citrix.Console.PowerShellSdk.BackgroundTaskService.BackgroundTask.Task.Run()

    DesktopStudio_ErrorId : ExceptionThrown
    Sdk Error Message : Illegal characters in path.
    Sdk Error ID : Citrix.XDPowerShell.Status.ExceptionThrown,Citrix.MachineCreation.Sdk.Commands.NewProvSchemeCommand
    ErrorCategory : NotSpecified
    DesktopStudio_PowerShellHistory : Create Machine Catalog '<CatalogName>'
    <ExceptionDateTime>
  
    Get-LogSite  -AdminAddress "<ControllerFQDN>:80"
    Start-LogHighLevelOperation  -AdminAddress "<ControllerFQDN>:80" -Source "Studio" -StartTime "<StartDateTime>" -Text "Create Machine Catalog `'<CatalogName>`'"
    New-BrokerCatalog  -AdminAddress "<ControllerFQDN>:80" -AllocationType "<AllocationType>" -Description "<Description>" -IsRemotePC <Boolean> -LoggingId "<LoggingId>" -MinimumFunctionalLevel "<MinimumFunctionalLevel>" -Name "<Name>" -PersistUserChanges "<PersistUserChanges>" -ProvisioningType "<ProvisioningType>" -Scope @() -SessionSupport "<SessionSupport>"

    New-AcctIdentityPool  -AdminAddress "<ControllerFQDN>:80" -IdentityPoolName "<IdentityPoolName>" -LoggingId "<LoggingId>" -Scope @()

    Set-BrokerCatalogMetadata  -AdminAddress "<ControllerFQDN>:80" -CatalogId <CatalogId> -LoggingId "<LoggingId>" -Name "<Name>" -Value "<Value>"

    Test-ProvSchemeNameAvailable  -AdminAddress "<ControllerFQDN>:80" -ProvisioningSchemeName @("<ProvisioningSchemeName")

    New-ProvScheme  -AdminAddress "<ControllerFQDN>:80" -CleanOnBoot -HostingUnitName "<HostingUnitName>" -IdentityPoolName "<IdentityPoolName>" -LoggingId "<LoggingId>" -MasterImageVM "<PathToMasterSnapshot>" -NetworkMapping @{"0"="<NetworkMappingContainingInvalidCharacters"} -ProvisioningSchemeName "<ProvisioningSchemeName>" -RunAsynchronously -Scope @() -VMCpuCount <VMCpuCount> -VMMemoryMB <VMMemoryMB>

    New-ProvScheme : Illegal characters in path.
                + CategoryInfo : NotSpecified: (:) [New-ProvScheme], ArgumentException
                + FullyQualifiedErrorId : Citrix.XDPowerShell.Status.ExceptionThrown,Citrix.MachineCreation.Sdk.Commands.NewProvSchemeCommand
    Stop-LogHighLevelOperation  -AdminAddress "<ControllerFQDN>:80" -EndTime "<EndDateTime" -HighLevelOperationId "<HighLevelOperationId>" -IsSuccessful <Boolean>

Resolution

Remove invalid characters from the name of any network resources used by the XenDesktop host connection.


Problem Cause

  • The -NetworkMapping variable of the New-ProvScheme command contains characters that are not valid for a path as defined by Microsoft.

  • The full set of invalid characters can vary by file system. For example, on Windows-based desktop platforms, invalid path characters might include ASCII/Unicode characters 1 through 31, as well as quote ("), less than (<), greater than (>), pipe (|), backspace (\b), null (\0) and tab (\t). For more information refer to MSDN documentation - (Path.GetInvalidPathChars Method ())

Issue/Introduction

Failure occurs when trying to create a machine catalog with error Id: XDDS:16489564 and error message "Illegal characters in path."