Partager via

New-SCCustomProperty

  • Référence
Module:
VirtualMachineManager

Crée une définition de propriété personnalisée dans la base de données VMM.

Syntax

New-SCCustomProperty
   [-Name] <String>
   [-Description <String>]
   -AddMember <CustomPropertyObjectType[]>
   [-VMMServer <ServerConnection>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

Description

L’applet de commande New-SCCustomProperty crée une définition de propriété personnalisée dans la base de données Virtual Machine Manager (VMM).

Vous pouvez créer une propriété personnalisée pour les types d’objets suivants :

  • Machine virtuelle
  • Modèle
  • VMHost
  • HostCluster
  • VMHostGroup
  • ServiceTemplate
  • ServiceInstance
  • ComputerTier
  • Cloud

Exemples

Exemple 1 : Créer une propriété personnalisée

PS C:\> $CustomProp = New-SCCustomProperty -Name "Cost Center" -AddMember "VM"
PS C:\> $CustomProp

La première commande crée un objet de propriété personnalisé nommé Cost Center avec une machine virtuelle en tant que membre et stocke l’objet dans la variable $CustomProp.

La deuxième commande affiche les propriétés de l’objet de propriété personnalisé stocké dans $CustomProp à l’utilisateur.

Paramètres

-AddMember

Spécifie un tableau de membres que cette applet de commande ajoute à un objet qui a le concept de membres, tel qu’un groupe. Par exemple, cette applet de commande peut ajouter un ou plusieurs utilisateurs ou groupes de domaine Active Directory® à un rôle d’utilisateur. Spécifiez les membres dans les formats suivants :

  • Domaine\utilisateur
  • Utilisateur
  • User@Domain
  • Domain\LabGroupAlias
  • LabGroupAlias

L’alias du groupe lab est un groupe de sécurité services de domaine Active Directory, et non un alias de messagerie.

Type:CustomPropertyObjectType[]
Accepted values:VM, Template, VMHost, HostCluster, VMHostGroup, ServiceTemplate, ServiceInstance, ComputerTier, Cloud, ProtectionUnit
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Description

Spécifie une description pour la définition de propriété personnalisée.

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

-JobVariable

Spécifie que la progression des travaux est suivie et stockée dans la variable nommée par ce paramètre.

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

-Name

Spécifie le nom d’un objet VMM.

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

-PROTipID

Spécifie l’ID de l’info-bulle d’optimisation des performances et des ressources (CONSEIL PRO) qui a déclenché cette action. Ce paramètre vous permet d’auditer les conseils PRO.

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

-RunAsynchronously

Indique que le travail s’exécute de manière asynchrone afin que le contrôle retourne immédiatement à l’interpréteur de commandes.

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

-VMMServer

Spécifie un objet serveur VMM.

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