Set-SCVirtualHardDisk
Modifie les propriétés d’un objet de disque dur virtuel utilisé dans VMM.
Syntax
Set-SCVirtualHardDisk
[-OperatingSystem <OperatingSystem>]
[-VirtualizationPlatform <VirtualizationPlatform>]
[-Tag <System.Collections.Generic.List`1[System.String]>]
[-ProductKey <String>]
[-UserRole <UserRole>]
[-Enabled <Boolean>]
[-VMMServer <ServerConnection>]
[-VirtualHardDisk] <VirtualHardDisk>
[-JobGroup <Guid>]
[-Name <String>]
[-SharePath <String>]
[-Description <String>]
[-Owner <String>]
[-FamilyName <String>]
[-Release <String>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[<CommonParameters>]
Set-SCVirtualHardDisk
[-VMMServer <ServerConnection>]
[-VirtualHardDisks] <System.Collections.Generic.List`1[Microsoft.SystemCenter.VirtualMachineManager.VirtualHardDisk]>
-FamilyName <String>
-Release <String>
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[<CommonParameters>]
Description
L’applet de commande Set-SCVirtualHardDisk modifie une ou plusieurs propriétés d’un objet de disque dur virtuel utilisé dans un environnement Virtual Machine Manager (VMM). Un fichier de disque dur virtuel utilisé dans VMM est un fichier .vhd Windows, un fichier .vhd citrix XenServer ou un fichier .vmdk basé sur VMware.
Les propriétés que vous pouvez modifier sont notamment :
- Description
- activé
- Nom
- Système d’exploitation
- Propriétaire
- SharePath
Un fichier de disque dur virtuel peut être stocké dans la bibliothèque VMM ou il peut être associé à un lecteur de disque virtuel sur un ordinateur virtuel ou un modèle.
Pour modifier les paramètres Bus et LUN d’un lecteur de disque virtuel, utilisez l’applet de commande Set-SCVirtualDiskDrive .
Exemples
Exemple 1 : Modifier la description d’un disque dur virtuel
PS C:\> $VHD = Get-SCVirtualHardDisk -VMMServer "VMMServer01.Contoso.com" | where { $_.LibraryServer.Name -eq "LibraryServer01.Contoso.com" -and $_.Name -eq "WindowsServer2008R2BootVHD.vhd"}
PS C:\> Set-SCVirtualHardDisk -VirtualHardDisk $VHD -Description "Latest Windows Server 2008 R2 Boot VHD"
La première commande récupère l’objet de disque dur virtuel nommé « WindowsServer2003BootVHD.vhd » à partir de la bibliothèque sur VMMServer01, puis stocke l’objet dans la variable $VHD.
La deuxième commande modifie la description de l’objet de disque dur virtuel stocké dans $VHD en « Dernier disque dur virtuel de démarrage Windows Server 2008 R2 ».
Exemple 2 : Activer un disque dur virtuel VMware dans la bibliothèque
PS C:\> $VMDK = Get-SCVirtualHardDisk -VMMServer "VMMServer01.Contoso.com" | where { $_.LibraryServer.Name -eq "LibraryServer01.Contoso.com" -and $_.Name -eq "WindowsServer2008.vmdk"}
PS C:\> Set-SCVirtualHardDisk -VirtualHardDisk $VMDK -Enabled $FALSE
La première commande obtient l’objet de disque dur virtuel nommé WindowsServer2008.vmdk, puis stocke l’objet de disque dur virtuel dans la variable $VMDK.
La deuxième commande désactive l’objet de disque dur virtuel stocké dans $VMDK.
Exemple 3 : Spécifier un propriétaire pour tous les disques durs virtuels avec un propriétaire « Inconnu »
PS C:\> Get-SCVirtualHardDisk -VMMServer "VMMServer01.Contoso.com" | where {$_.Owner -eq "Unknown"} | Set-SCVirtualHardDisk -Owner "Contoso\ReneeLo"
Cette commande obtient tous les objets de disque dur virtuel de la bibliothèque VMM dont le propriétaire est « Inconnu », puis spécifie un propriétaire pour chaque objet de disque dur virtuel.
Paramètres
-Description
Spécifie une description de l’objet de disque dur virtuel.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Enabled
Active un objet lorsqu’il est défini sur $True ou désactive un objet lorsqu’il est défini sur $False. Par exemple, pour effectuer la mise à niveau d’un logiciel sur un modèle d’ordinateur virtuel, vous pouvez désactiver l’objet modèle dans la bibliothèque Virtual Machine Manager pour empêcher temporairement les utilisateurs d’utiliser cet objet.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-FamilyName
Spécifie un nom de famille pour une ressource physique dans la bibliothèque VMM. Cette valeur est utilisée conjointement avec Release, Namespace et Type pour établir l’équivalence entre les ressources de bibliothèque.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-JobGroup
Spécifie un identificateur pour une série de commandes qui seront exécutées ensemble juste avant que la commande finale qui comprend le même identificateur de groupe de travaux soit exécutée.
Type: | Guid |
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 |
-OperatingSystem
Spécifie le type de système d’exploitation d’un ordinateur virtuel.
Pour répertorier les noms de tous les systèmes d’exploitation disponibles dans VMM, tapez Get-SCOperatingSystem
.
Type: | OperatingSystem |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Owner
Spécifie le propriétaire d’un objet VMM sous la forme d’un compte d’utilisateur de domaine valide.
- Exemple de format :
-Owner "Contoso\PattiFuller"
- Exemple de format :
-Owner "PattiFuller@Contoso"
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ProductKey
Spécifie une clé de produit. La clé de produit est un numéro à 25 chiffres qui identifie la licence du produit. Une clé de produit peut être utilisée pour inscrire VMM ou un système d’exploitation à installer sur une machine virtuelle ou un hôte.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
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 |
-Release
Spécifie une chaîne qui décrit la mise en production d’une ressource de bibliothèque. VMM crée automatiquement une valeur de mise en production pour chaque ressource importée dans la bibliothèque. Une fois la ressource importée, la chaîne peut être personnalisée.
Type: | String |
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 |
-SharePath
Spécifie un chemin d’accès à un partage de bibliothèque valide sur un serveur de bibliothèque existant qui utilise un chemin d’accès UNC (Universal Naming Convention).
Exemple de format : -SharePath "\\LibServer01\LibShare"
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Tag
Spécifie un mot ou une expression à associer à un objet afin que vous puissiez rechercher tous les objets avec l’ensemble spécifié de balises. Vous pouvez rechercher un sous-ensemble de balises ou rechercher l’ensemble complet des balises.
Type: | System.Collections.Generic.List`1[System.String] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UserRole
Spécifie un objet rôle d'utilisateur.
Type: | UserRole |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-VirtualHardDisk
Spécifie un objet disque dur virtuel.
Type: | VirtualHardDisk |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-VirtualHardDisks
Spécifie un tableau d’objets de disque dur virtuel.
Type: | System.Collections.Generic.List`1[Microsoft.SystemCenter.VirtualMachineManager.VirtualHardDisk] |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-VirtualizationPlatform
Spécifie la plateforme de virtualisation d’un hôte de machine virtuelle gérée par VMM. Les valeurs valides pour ce paramètre sont :
- Hyper-V
- VMwareESX
- Xenserver
Type: | VirtualizationPlatform |
Accepted values: | Unknown, VirtualServer, HyperV, VMWareVC, VMWareESX, XENServer |
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 |
Sorties
VirtualHardDisk
Cette applet de commande retourne un objet VirtualHardDisk .
Notes
- Nécessite un objet de disque dur virtuel VMM, qui peut être récupéré à l’aide de l’applet de commande Get-SCVirtualHardDisk .