Set-SCCustomProperty
Modifie les propriétés d’une propriété personnalisée.
Syntaxe
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
La cmdlet 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é Des services de domaine Active Directory, et non un alias de messagerie.
| Type: | CustomPropertyObjectType[] |
| Valeurs acceptées: | VM, Template, VMHost, HostCluster, VMHostGroup, ServiceTemplate, ServiceInstance, ComputerTier, Cloud, ProtectionUnit |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-CustomProperty
Spécifie un objet de propriété personnalisé.
| Type: | CustomProperty |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | True |
| Accepter les caractères génériques: | False |
-Description
Spécifie une description de l’objet spécifié.
| Type: | String |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-JobVariable
Spécifie que la progression du travail est suivie et stockée dans la variable nommée par ce paramètre.
| Type: | String |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-Name
Spécifie le nom d’un objet VMM.
| Type: | String |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | 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 |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | 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 utilisateurs ou groupes de domaine Active Directory 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é Des services de domaine Active Directory, et non un alias de messagerie.
| Type: | CustomPropertyObjectType[] |
| Valeurs acceptées: | VM, Template, VMHost, HostCluster, VMHostGroup, ServiceTemplate, ServiceInstance, ComputerTier, Cloud, ProtectionUnit |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-RunAsynchronously
Indique que le travail s’exécute de façon asynchrone afin que le contrôle retourne immédiatement à l’interpréteur de commandes.
| Type: | SwitchParameter |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-VMMServer
Spécifie un objet serveur VMM.
| Type: | ServerConnection |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | True |
| Accepter les caractères génériques: | False |