Set-SCVirtualMachine

Référence

Module:: VirtualMachineManager

Modifie les propriétés d’une machine virtuelle gérée par VMM.

Syntax

Set-SCVirtualMachine
   [-VM] <VM>
   [-VMwareResourcePool <VmwResourcePool>]
   [-StartAction <VMStartAction>]
   [-StopAction <VMStopAction>]
   [-RemoveSelfServiceUserRole <Boolean>]
   [-EnableOperatingSystemShutdown <Boolean>]
   [-EnableTimeSync <Boolean>]
   [-EnableDataExchange <Boolean>]
   [-EnableHeartbeat <Boolean>]
   [-EnableBackup <Boolean>]
   [-InstallVirtualizationGuestServices <Boolean>]
   [-Owner <String>]
   [-OperatingSystem <OperatingSystem>]
   [-Enabled <Boolean>]
   [-HighlyAvailable <Boolean>]
   [-HAVMPriority <UInt32>]
   [-DRProtectionRequired <Boolean>]
   [-ReplicationGroup <ReplicationGroup>]
   [-SecureBootEnabled <Boolean>]
   [-NumLock <Boolean>]
   [-CPULimitFunctionality <Boolean>]
   [-CPULimitForMigration <Boolean>]
   [-VMShieldingData <KeyFile>]
   [-RunAsSystem]
   [-RunAsUserCredential <PSCredential>]
   [-DelayStartSeconds <Int32>]
   [-UseHardwareAssistedVirtualization <Boolean>]
   [-Cloud <Cloud>]
   [-CapabilityProfile <CapabilityProfile>]
   [-RemoveCapabilityProfile]
   [-RemoveFromCloud]
   [-ClusterNonPossibleOwner <System.Collections.Generic.List`1[Microsoft.SystemCenter.VirtualMachineManager.Host]>]
   [-ClusterPreferredOwner <System.Collections.Generic.List`1[Microsoft.SystemCenter.VirtualMachineManager.Host]>]
   [-AvailabilitySetNames <System.Collections.Generic.List`1[System.String]>]
   [-UserRole <UserRole>]
   [-Name <String>]
   [-JobGroup <Guid>]
   [-QuotaPoint <UInt32>]
   [-CostCenter <String>]
   [-Tag <String>]
   [-Custom1 <String>]
   [-Custom2 <String>]
   [-Custom3 <String>]
   [-Custom4 <String>]
   [-Custom5 <String>]
   [-Custom6 <String>]
   [-Custom7 <String>]
   [-Custom8 <String>]
   [-Custom9 <String>]
   [-Custom10 <String>]
   [-BlockDynamicOptimization <Boolean>]
   [-ClearDRProtection]
   [-Description <String>]
   [-MemoryMB <Int32>]
   [-DynamicMemoryEnabled <Boolean>]
   [-DynamicMemoryMaximumMB <Int32>]
   [-DynamicMemoryBufferPercentage <Int32>]
   [-MemoryWeight <Int32>]
   [-VirtualVideoAdapterEnabled <Boolean>]
   [-MonitorMaximumCount <Int32>]
   [-MonitorMaximumResolution <String>]
   [-RecoveryPointObjective <Int32>]
   [-ProtectionProvider <ProtectionProvider>]
   [-BootOrder <BootDevice[]>]
   [-FirstBootDevice <String>]
   [-SecureBootTemplate <String>]
   [-CPUCount <Byte>]
   [-CPUType <ProcessorType>]
   [-CPUExpectedUtilizationPercent <Int32>]
   [-DiskIops <Int32>]
   [-NetworkUtilizationMbps <Int32>]
   [-CPURelativeWeight <Int32>]
   [-CPUReserve <Int32>]
   [-CPUMaximumPercent <Int32>]
   [-CPUPerVirtualNumaNodeMaximum <Byte>]
   [-MemoryPerVirtualNumaNodeMaximumMB <Int32>]
   [-VirtualNumaNodesPerSocketMaximum <Byte>]
   [-DynamicMemoryMinimumMB <Int32>]
   [-NumaIsolationRequired <Boolean>]
   [-AutomaticCriticalErrorAction <UInt16>]
   [-AutomaticCriticalErrorActionTimeout <Int32>]
   [-CheckpointType <CheckpointType>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

Description

L’applet de commande Set-SCVirtualMachine modifie les propriétés d’une machine virtuelle gérée par Virtual Machine Manager (VMM).

Les propriétés que vous pouvez modifier sont les suivantes :

Associez une machine virtuelle à un cloud.
Nom, propriétaire et description d’une machine virtuelle.
Ordre de démarrage du BIOS, si la machine virtuelle est déployée sur un hôte Hyper-V.
Quantité de ressources sur l’hôte utilisée par une machine virtuelle. Ces options en question sont les suivantes :
Quantité maximale de ressources du processeur hôte qu’une machine virtuelle peut utiliser.
Utilisation attendue du processeur hôte par une machine virtuelle.
Quantité de ressources processeur hôtes utilisées par une machine virtuelle par rapport à d’autres machines virtuelles sur le même hôte.
Quantité de mémoire hôte qu’une machine virtuelle peut utiliser.
Quantité de bande passante sur le réseau de l’hôte qu’une machine virtuelle peut utiliser.
Paramètres matériels d’une machine virtuelle non liée aux ressources hôtes. Ces options en question sont les suivantes :
Nombre de processeurs.
Type de processeur.
Nombre d’opérations d’entrée/sortie de disque par seconde (IOPS).
Limitation des fonctionnalités du processeur pour un système d’exploitation plus ancien, tel que Windows NT 4.0.
Centre de coûts, étiquette et paramètres personnalisés utilisés pour filtrer les machines virtuelles par critères.
Paramètres qui activent diverses fonctionnalités facultatives, notamment les suivantes :
Activation ou désactivation d’un objet de bibliothèque pour le rendre disponible, ou temporairement indisponible, pour les utilisateurs.
Activation de la sauvegarde d’une machine virtuelle sur un hôte Hyper-V avec le service De cliché instantané de volume.
Activation d’une paire clé/valeur pour l’échange de données entre une machine virtuelle et son hôte Hyper-V.
Activation de l’arrêt d’une machine virtuelle à partir de la console Hyper-V.
Activation de la synchronisation d’heure entre une machine virtuelle et son hôte Hyper-V.
Activation de la valeur BIOS pour NumLock pour une machine virtuelle sur un hôte Hyper-V.
Paramètre qui identifie si une machine virtuelle est hautement disponible, c’est-à-dire une machine virtuelle à déployer sur un nœud d’un cluster hôte Hyper-V ou d’un cluster hôte Citrix XenServer.
Paramètre qui détermine si les services invités de virtualisation sont installés sur une machine virtuelle déployée sur un hôte Hyper-V.
Nombre de secondes à retarder avant de démarrer une machine virtuelle.
Paramètre qui identifie le système d’exploitation utilisé pour une machine virtuelle.
Démarrer et arrêter des actions pour une machine virtuelle.
Paramètre qui limite le nombre de machines virtuelles que les utilisateurs libre-service peuvent créer.
Paramètre utilisé pour changer le rôle qu’un utilisateur libre-service qui appartient à plusieurs rôles utilise pour gérer une machine virtuelle.
Paramètre qui affecte une machine virtuelle sur un hôte ESX à un pool de ressources VMware.

Si vous souhaitez modifier les propriétés d’un lecteur de disquette virtuel, d’un lecteur DVD virtuel, d’une carte réseau virtuelle ou d’une carte SCSI virtuelle associée à une machine virtuelle spécifique, utilisez l’applet de commande Set-SCVirtualFloppyDrive, Set-SCVirtualDVDDrive, Set-SCVirtualNetworkAdapter ou Set-SCVirtualScsiAdapter .

Exemples

Exemple 1 : Spécifier une quantité de mémoire pour une machine virtuelle existante

PS C:\> $VM = Get-SCVirtualMachine -Name "VM01"
PS C:\> If($VM.Status -ne "PowerOff"){Stop-SCVirtualMachine -VM $VM}
PS C:\> Set-SCVirtualMachine -VM $VM -MemoryMB 1024

La première commande obtient l’objet de machine virtuelle nommé VM01, puis stocke cet objet dans la variable $VM.

La deuxième détermine si la machine virtuelle stockée dans $VM est hors tension. Si la machine virtuelle n’est pas hors tension, la commande utilise la commande Stop-SCVirtualMachine pour mettre hors tension la machine virtuelle. Pour plus d’informations sur la mise hors tension d’une machine virtuelle, tapez Get-Help Stop-SCVirtualMachine.

La dernière commande modifie la quantité de mémoire allouée à VM01 pour lui attribuer la valeur 1 024 Mo.

Exemple 2 : Modifier le rôle d’utilisateur utilisé pour gérer une machine virtuelle pour un utilisateur qui appartient à plusieurs rôles d’utilisateur libre-service

PS C:\> $VM = Get-SCVirtualMachine -VMMServer "VMMServer01.Contoso.com" -Name "VM02"
PS C:\> $SSRole = Get-SCUserRole -Name "ContosoSelfServiceUsers"
PS C:\> Set-SCVirtualMachine -VM $VM -UserRole $SSRole

La première commande obtient l’objet de machine virtuelle nommé VM02 à partir de VMMServer01, puis stocke cet objet dans la variable $VM.

La deuxième commande obtient l’objet de rôle utilisateur nommé ContosoSelfServiceUsers, puis stocke l’objet dans la variable $SSRole.

La dernière commande spécifie que les membres du rôle d’utilisateur libre-service appelé SSUserRole3 ont désormais l’autorisation de gérer la machine virtuelle appelée VM02.

Remarque : VMM utilise le paramètre UserRole pour définir les machines virtuelles gérées par les membres d’un rôle d’utilisateur libre-service spécifique. En règle générale, vous n’avez pas besoin d’utiliser l’applet de commande Set-SCVirtualMachine avec le paramètre UserRole pour configurer ce paramètre. Toutefois, si un ou plusieurs utilisateurs sont membres de plusieurs rôles d’utilisateur libre-service et que vous leur accordez l’autorisation de gérer plusieurs machines virtuelles sur le même hôte, vous pouvez rencontrer un cas où vous souhaitez changer de rôle d’utilisateur autorisé à gérer une machine virtuelle particulière. Cet exemple illustre ce scénario.

Exemple 3 : Désactiver la synchronisation de temps sur une machine virtuelle utilisée comme contrôleur de domaine

PS C:\> $EAP = $ErrorActionPreference
PS C:\> $ErrorActionPreference = "STOP"
PS C:\> $VM = Get-SCVirtualMachine -Name "VM03"
PS C:\> trap{"Fail: Cannot disable Time Synchronization for VM: $VM";continue} Set-SCVirtualMachine -VM $VM -EnableTimeSynchronization $TRUE | Out-Null
PS C:\> $ErrorActionPreference = $EAP

La première commande stocke la valeur actuelle de $ErrorActionPreference dans la variable $EAP. Cette variable est utilisée ultérieurement pour renvoyer le paramètre à sa valeur d’origine.

La deuxième commande définit la préférence d’action à la valeur STOP. Cette préférence d’action modifie une erreur sans fin d’exécution en une erreur avec fin d’exécution. L’objet d’erreur est déclenché en tant qu’exception au lieu d’être écrit dans le canal de sortie, et la commande ne continue pas à s’exécuter.

La troisième commande obtient l’objet de machine virtuelle nommé VM03 et stocke cet objet dans la variable $VM.

La quatrième commande désactive le paramètre de synchronisation de l’heure. En règle générale, la désactivation de la synchronisation de temps est requise pour les machines virtuelles qui agissent en tant que contrôleurs de domaine. La commande utilise l’instruction trap pour intercepter les exceptions de fin. Si la commande Set-SCVirtualMachine échoue, la chaîne de l’instruction trap s’affiche. Continue est utilisé dans l’instruction trap pour continuer à s’exécuter au lieu de quitter. La cmdlet Out-Null redirige la sortie vers $Null au lieu de l’envoyer vers la console.

La dernière commande définit le paramètre $ErrorActionPreference avec la valeur stockée dans $EAP.

Exemple 4 : Définir l’ordre de démarrage de l’appareil pour toutes les machines virtuelles qui prennent en charge cette fonctionnalité

PS C:\> $EAP = $ErrorActionPreference
PS C:\> $ErrorActionPreference = "Stop"
PS C:\> $VMs = @(Get-SCVirtualMachine)
PS C:\> ForEach($VM in $VMs){trap{"Fail: Cannot set BIOS for VM: $VM";continue} Set-SCVirtualMachine -VM $VM -BootOrder "PXEBoot","IDEHarddrive","CD","Floppy" | Out-Null}
PS C:\> $ErrorActionPreference = $EAP

La première commande stocke la valeur actuelle de $ErrorActionPreference dans la variable $EAP. Cette variable est utilisée ultérieurement pour renvoyer le paramètre à sa valeur d’origine.

La deuxième commande définit la préférence d’action d’erreur sur Arrêter. Cette préférence d’action modifie une erreur sans fin d’exécution en une erreur avec fin d’exécution. L’objet d’erreur est déclenché en tant qu’exception au lieu d’être écrit dans le canal de sortie, et la commande ne continue pas à s’exécuter.

La troisième commande obtient chaque objet de machine virtuelle stocke les objets dans $VMs. L’utilisation du symbole @ et des parenthèses permet de s’assurer que la commande stocke les résultats dans un tableau au cas où la commande retourne un objet unique ou une valeur null.

La quatrième commande définit l’ordre de démarrage du BIOS pour chaque machine virtuelle sur PXEBoot,IDEHarddrive,CD,Floppy. La commande utilise une instruction d’interruption pour intercepter les exceptions de fin. Si la commande Set-SCVirtualMachine échoue, la chaîne de l’instruction trap s’affiche. Continue est utilisé dans l’instruction trap pour continuer à s’exécuter au lieu de quitter la boucle ForEach . L’applet de commande Out-Null redirige la sortie vers $Null au lieu de l’envoyer à la console.

Remarque : Le paramètre BootOrder est utilisé uniquement pour les machines virtuelles sur les hôtes Hyper-V et Citrix XenServer. Il n’est pas utilisé pour les machines virtuelles sur les hôtes VMware ESX. Les hôtes XenServer ne prennent pas en charge les disquettes et ignorent donc la disquette si elles sont répertoriées dans l’ordre de démarrage.

La dernière commande définit le paramètre $ErrorActionPreference avec la valeur stockée dans $EAP.

Pour plus d’informations sur l’instruction de boucle Windows PowerShell ForEach standard, tapez Get-Help about_ForEach.

Exemple 5 : Spécifier un propriétaire pour toutes les machines virtuelles sans propriétaire

PS C:\> Get-SCVirtualMachine -VMMServer "VMMServer01.Contoso.com" | where {$_.Owner -eq ""} | Set-SCVirtualMachine -Owner "Contoso\ReneeLo"

Cette commande obtient tous les objets de machine virtuelle sur VMMServer01, sélectionne uniquement les objets de machine virtuelle où aucun propriétaire n’est répertorié et spécifie un propriétaire pour chaque machine virtuelle.

Exemple 6 : Activer la mémoire dynamique pour une machine virtuelle existante

PS C:\> $VM = Get-SCVirtualMachine -Name "VM06"
PS C:\> if($VM.Status -ne "PowerOff"){Stop-SCVirtualMachine -VM $VM}
PS C:\> Set-SCVirtualMachine -VM $VM -DynamicMemoryEnabled $True -MemoryMB 1024 -DynamicMemoryMaximumMB 2048

La première commande obtient l’objet de machine virtuelle VM06 et stocke cet objet dans la variable $VM. Pour activer la mémoire dynamique sur une machine virtuelle, la machine virtuelle doit résider sur un hôte qui exécute Windows Server 2008 R2 SP1 ou une version ultérieure.

La deuxième commande détermine si la machine virtuelle stockée dans $VM est hors tension. Si la machine virtuelle n’est pas hors tension, la commande utilise la commande Stop-SCVirtualMachine pour mettre hors tension la machine virtuelle.

La dernière commande active la mémoire dynamique, définit la mémoire de démarrage sur 1 024 Mo et définit la mémoire maximale sur 2 048 Mo. La mémoire de démarrage est la quantité de mémoire sur l’hôte allouée à VM06 au démarrage. La mémoire maximale est la quantité maximale de mémoire sur l’hôte allouée à VM06.

Paramètres

-AutomaticCriticalErrorAction

Spécifie l’action à effectuer lorsque la machine virtuelle rencontre une erreur critique et dépasse le délai d’expiration spécifié par le paramètre AutomaticCriticalErrorActionTimeout . Les valeurs acceptables pour ce paramètre sont : Pause et Aucun.

Type:	UInt16
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AutomaticCriticalErrorActionTimeout

Spécifie la durée, en minutes, d’attente pendant une pause critique avant de mettre hors tension la machine virtuelle.

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AvailabilitySetNames

Spécifie une liste de noms de groupes à haute disponibilité.

Type:	System.Collections.Generic.List`1[System.String]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-BlockDynamicOptimization

Indique si l’optimisation dynamique est bloquée pour une machine virtuelle.

Type:	Boolean
Aliases:	ExcludeFromPRO
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-BootOrder

Spécifie l’ordre, sous forme de tableau, des appareils qu’une machine virtuelle sur un hôte Hyper-V utilise pour démarrer. Les valeurs autorisées sont :

CD
IDEHardDrive
PXEBoot
Floppy

Type:	BootDevice[]
Accepted values:	Floppy, CD, IdeHardDrive, PxeBoot, Unknown
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-CapabilityProfile

Spécifie un objet de profil de capacité.

Type:	CapabilityProfile
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-CheckpointType

Spécifie le type de point de contrôle. Les valeurs valides pour ce paramètre sont :

Désactivé
Production
ProductionOnly
standard

Type:	CheckpointType
Accepted values:	Disabled, Production, ProductionOnly, Standard
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ClearDRProtection

Indique que cette applet de commande réinitialise l’option de protection contre la récupération de données.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Cloud

Spécifie un objet de cloud privé.

Type:	Cloud
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ClusterNonPossibleOwner

Spécifie la liste des noms des propriétaires de nœuds de cluster non possibles pour une machine virtuelle spécifiée.

Type:	System.Collections.Generic.List`1[Microsoft.SystemCenter.VirtualMachineManager.Host]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ClusterPreferredOwner

Spécifie la liste des noms des propriétaires de nœuds de cluster préférés pour une machine virtuelle particulière.

Type:	System.Collections.Generic.List`1[Microsoft.SystemCenter.VirtualMachineManager.Host]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-CostCenter

Spécifie le centre de coûts pour une machine virtuelle. Vous pouvez collecter des données sur l’allocation de machines virtuelles ou de ressources allouées à des machines virtuelles pour votre système de facturation.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-CPUCount

Spécifie le nombre de processeurs sur la machine virtuelle. Les hôtes suivants prennent en charge le nombre de processeurs suivant :

Hyper-V. Jusqu’à quatre processeurs par machine virtuelle, selon le système d’exploitation invité.
VMware ESX. Jusqu’à quatre processeurs par machine virtuelle pour tout système d’exploitation invité pris en charge, à l’exception d’un processeur sur une machine virtuelle qui exécute Windows NT 4.0.
Citrix XenServer. Jusqu’à huit processeurs par machine virtuelle, selon le système d’exploitation invité.

Type:	Byte
Aliases:	ProcessorCount
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-CPUExpectedUtilizationPercent

Spécifie le pourcentage d’UC sur l’hôte que vous attendez de cette machine virtuelle à utiliser. Cette valeur est utilisée uniquement lorsque VMM détermine un hôte approprié pour la machine virtuelle.

Type:	Int32
Aliases:	ExpectedCPUUtilization
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-CPULimitForMigration

Indique s’il faut limiter les fonctionnalités de processeur pour la machine virtuelle spécifiée afin d’activer la migration vers un ordinateur physique qui a une version différente du même processeur que l’ordinateur source. VMM ne prend pas en charge la migration d'ordinateurs virtuels entre ordinateurs physiques dotés de processeurs provenant de fabricants différents.

Type:	Boolean
Aliases:	LimitCPUForMigration
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-CPULimitFunctionality

Indique s’il faut fournir des fonctionnalités d’UC limitées pour la machine virtuelle. Spécifiez la valeur $True pour prendre en charge un système d’exploitation plus ancien, tel que Windows NT 4.0, sur une machine virtuelle déployée sur un hôte Hyper-V ou sur un hôte VMware ESX.

Type:	Boolean
Aliases:	LimitCPUFunctionality
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-CPUMaximumPercent

Spécifie le pourcentage le plus élevé des ressources totales d’un seul processeur sur l’hôte qu’une machine virtuelle peut utiliser en même temps.

Type:	Int32
Aliases:	CPUMax
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-CPUPerVirtualNumaNodeMaximum

Spécifie le nombre maximal de processeurs autorisés pour chaque nœud NUMA virtuel.

Type:	Byte
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-CPURelativeWeight

Spécifie la quantité de ressources processeur d’un ordinateur hôte que cet ordinateur virtuel peut utiliser par rapport aux autres ordinateurs virtuels du même ordinateur hôte. Une machine virtuelle avec une valeur de pondération plus élevée se voit allouer plus de ressources processeur qu’une machine virtuelle avec une valeur de pondération inférieure. Le terme VMware pour ces valeurs est partage. Les types d’hôtes prennent en charge les valeurs relatives suivantes :

Hyper-V. 1 à 10000.
VMware ESX. Élevée. 2000.
VMware ESX. Au-dessus de la normale. 1500.
VMware ESX. Normal (valeur par défaut). 1000.
VMware ESX. En dessous de la normale. 750.
VMware ESX. Faible. 500.
VMware ESX. Personnalisé 1 à 10000000.
Citrix XenServer. 1 à 65536, typique est 256.

Type:	Int32
Aliases:	RelativeWeight
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-CPUReserve

Spécifie le pourcentage minimal des ressources d’un seul processeur sur l’hôte à allouer à la machine virtuelle. Le pourcentage de capacité du processeur qui est mis à la disposition de l’ordinateur virtuel n’est jamais inférieur à ce pourcentage.

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-CPUType

Spécifie le type de processeur pour un ordinateur virtuel. Pour obtenir tous les types d’UC disponibles pour une utilisation dans des machines virtuelles dans un environnement VMM, consultez l’applet de commande Get-SCCPUType .

Type:	ProcessorType
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False