Partager via


Set-SCCustomProperty

Modifie les propriétés d’une propriété personnalisée.

Syntax

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

Description

L’applet de commande Set-SCCustomProperty modifie les propriétés d’une propriété personnalisée. Les propriétés qui peuvent être modifiées sont les suivantes :

  • Description de la propriété personnalisée
  • Nom de la propriété personnalisée
  • Ajouter un membre à la propriété personnalisée
  • Supprimer un membre de la propriété personnalisée

Pour plus d’informations sur la création d’une propriété personnalisée, tapez Get-Help New-SCCustomProperty -Detailed.

Exemples

Exemple 1 : Ajouter un membre à une propriété personnalisée

PS C:\> $CustomProp = Get-SCCustomProperty -Name "Cost Center"
PS C:\> Set-SCCustomProperty -CustomProperty $CustomProp -AddMember "VMHost"

La première commande obtient l’objet de propriété personnalisé nommé Cost Center et stocke l’objet dans la variable $CustomProp.

La deuxième commande ajoute le membre VMHost à la propriété personnalisée stockée dans $CustomProp.

Exemple 2 : Supprimer un membre d’une propriété personnalisée

PS C:\> $CustomProp = Get-SCCustomProperty -Name "Cost Center"
PS C:\> Set-SCCustomProperty -CustomProperty $CustomProp -RemoveMember "VM"

La première commande obtient l’objet de propriété personnalisé nommé Cost Center et stocke l’objet dans la variable $CustomProp.

La deuxième commande supprime le membre de machine virtuelle de l’objet de propriété personnalisé stocké dans $CustomProp.

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 de groupe lab est un groupe de sécurité services de domaine Active Directory, pas 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

-CustomProperty

Spécifie un objet de propriété personnalisé.

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

-Description

Spécifie une description pour l’objet spécifié.

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:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PROTipID

Spécifie l’ID du conseil d’optimisation des performances et des ressources 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

-RemoveMember

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

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

L’alias de groupe lab est un groupe de sécurité services de domaine Active Directory, pas 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

-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