Partager 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.

Syntaxe

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é, 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 données de protection des machines virtuelles pour des tâches telles que le chiffrement des modules de plateforme sécurisée virtuelle, la création de machines virtuelles dotées d’une protection maximale et le grand-père de machines virtuelles non protégées.

La base de données VMM gère les objets de données de protection des machines virtuelles 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 que le paramètre VMShieldingDataPath spécifie.

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 sous forme de tableau d’octets dans 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 que le paramètre RawData spécifie.

Paramètres

-Description

Spécifie une description de l’objet VMShieldingData.

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 le nom d’une variable dans laquelle la progression du travail est suivie et stockée.

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 un nom pour l’objet VMShieldingData.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques: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
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-OnBehalfOfUserRole

Spécifie un rôle d’utilisateur. Pour obtenir un rôle d’utilisateur, utilisez la cmdlet 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
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

-RawData

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

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

-VMShieldingDataPath

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

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Entrées

None

Sorties

VMShieldingData

Cette applet de commande retourne un objet de données de protection de machine virtuelle qui contient les informations suivantes :

  • RawData
  • KeyProtectorOwner
  • KeyProtectorGuardians
  • Nom
  • Description