Share via

New-SCVMShieldingData

  • Référence
Module:
VirtualMachineManager

Crée un objet de données de protection de machine virtuelle à partir d’un fichier .pdk.

Syntax

New-SCVMShieldingData
   [-VMMServer <ServerConnection>]
   -VMShieldingDataPath <String>
   -Name <String>
   [-Description <String>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
New-SCVMShieldingData
   [-VMMServer <ServerConnection>]
   -RawData <Byte[]>
   -Name <String>
   [-Description <String>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

Description

L’applet de commande New-SCVMShieldingData crée un objet VMShieldingData à partir d’un objet blob d’approvisionnement sécurisé, d’un fichier .pdk, dans Virtual Machine Manager (VMM). Ce fichier inclut des informations telles que des clés de propriété de machine virtuelle, des informations de personnalisation de machine virtuelle, des hachages de clés sources acceptables et d’autres informations. Les locataires créent un objet blob d’approvisionnement à l’aide d’un outil hors bande.

Vous pouvez utiliser un objet de protection des données de machine virtuelle pour des tâches telles que le chiffrement des modules de plateforme sécurisée (TPMs), la création de machines virtuelles protégées et le grand-père de machines virtuelles non protégées.

La base de données VMM gère la protection des objets de données de la machine virtuelle en tant que ressource de bibliothèque. Elles sont délimitées de manière appropriée pour le rôle d’utilisateur associé. VMM fournit des fonctionnalités de création, de lecture, de mise à jour et de suppression pour les gérer.

Exemples

Exemple 1 : Créer une machine virtuelle qui protège les données à l’aide d’un fichier .pdk

PS C:\> New-SCVMShieldingData -Name "ShieldingData01" -Description "Shielding data" -VMShieldingDataPath "C:\virtual\SD.pdk"

Cette commande crée un objet de données de protection de machine virtuelle nommé ShieldingData01. La commande base l’objet sur le fichier SD.pdk spécifié par le paramètre VMShieldingDataPath .

Exemple 2 : Créer une machine virtuelle qui protège les données à l’aide de données brutes

PS C:\> $Bytes = [System.IO.File]::ReadAllBytes ("C:\virtual\SD.pdk")
PS C:\> New-SCVMShieldingData -Name "ShieldingData02" -Description "Shielding data" -RawData $Bytes

La première commande stocke le contenu de SD.pdf en tant que tableau d’octets sur la variable $Bytes.

Cette commande crée un objet de données de protection de machine virtuelle nommé ShieldingData02. La commande base l’objet sur le tableau $Bytes spécifié par le paramètre RawData .

Paramètres

-Description

Spécifie une description de l’objet VMShieldingData .

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

-JobVariable

Spécifie le nom d’une variable dans laquelle la progression du travail est suivie et stockée.

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

-Name

Spécifie un nom pour l’objet VMShieldingData .

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

-OnBehalfOfUser

Spécifie un nom d'utilisateur. Cette applet de commande fonctionne pour le compte de l’utilisateur que ce paramètre spécifie.

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

-OnBehalfOfUserRole

Spécifie un rôle d’utilisateur. Pour obtenir un rôle d’utilisateur, utilisez l’applet de commande Get-SCUserRole . Cette applet de commande fonctionne pour le compte du rôle d’utilisateur spécifié par ce paramètre.

Type:UserRole
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

-RawData

Spécifie un tableau d’octets qui contiennent des données .pdk brutes.

Type:Byte[]
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

-VMShieldingDataPath

Spécifie le chemin d’accès d’un fichier .pdk.

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

Entrées

None

Sorties

VMShieldingData

Cette applet de commande retourne un objet de données de protection des machines virtuelles qui contient les informations suivantes :

  • RawData
  • KeyProtectorOwner
  • KeyProtectorGuardians
  • Nom
  • Description