Win32_EncryptableVolume-Klasse

Die WMI-Anbieterklasse Win32_EncryptableVolume stellt einen Speicherbereich auf einer Festplatte dar, der mithilfe der BitLocker-Laufwerkverschlüsselung geschützt werden kann. Nur NTFS-Volumes können verschlüsselt werden. Dabei kann es sich um ein Volume, das ein Betriebssystem enthält, oder um ein Datenvolume auf dem lokalen Datenträger handeln. Es kann sich nicht um ein Netzlaufwerk handeln.

Um die Vorteile von BitLocker zu nutzen, müssen Sie eine Schutzmethode für den Verschlüsselungsschlüssel des Volumes angeben und dann das Volume vollständig verschlüsseln.

Um den Verschlüsselungsschlüssel des Volumes zu schützen, fügen Sie mithilfe der folgenden Methoden Schlüsselschutzvorrichtungen hinzu:

• ProtectKeyWithCertificateFile
• ProtectKeyWithCertificateThumbprint
• ProtectKeyWithExternalKey
• ProtectKeyWithNumericalPassword
• ProtectKeyWithPassphrase
• ProtectKeyWithTPM
• ProtectKeyWithTPMAndPIN
• ProtectKeyWithTPMAndPINAndStartupKey
• ProtectKeyWithTPMAndStartupKey

Jeder Schlüsselschutzvorrichtungstyp bietet eine andere Authentifizierungsfunktionalität zum Entsperren des Zugriffs auf die verschlüsselten Daten. Externe Schlüssel und numerische Kennwörter können während Wiederherstellungsszenarien eine Authentifizierung bereitstellen. Bei TPM-basierten (Trusted Platform Module) Schlüsselschutzvorrichtungen müssen Sie möglicherweise zuerst das TPM ordnungsgemäß initialisieren. Weitere Informationen finden Sie im Artikel zur WMI-Anbieterklasse Win32_Tpm.

Verwenden Sie die Encrypt- oder EncryptAfterHardwareTest-Methode, um mit der Verschlüsselung zu beginnen. Schlüsselschutzvorrichtungen müssen vor dem Starten der Verschlüsselung hinzugefügt werden. Andernfalls müssen Sie die DisableKeyProtectors-Methode verwenden, um einen nicht geschützten unverschlüsselten Schlüssel verfügbar zu machen. Wenn der Computer während der Verschlüsselung ausgeschaltet wird, wird die Verschlüsselung beim Neustart des Computers automatisch fortgesetzt.

Sie können die GetConversionStatus- und GetProtectionStatus-Methoden verwenden, um den Status eines Volumes zu überprüfen, auf das zugegriffen werden kann.

Syntax

class Win32_EncryptableVolume
{
  string DeviceID;
  string PersistentVolumeID;
  string DriveLetter;
  uint32 ProtectionStatus;
};

Member

Die Win32_EncryptableVolume-Klasse verfügt über die folgenden Membertypen:

• Methoden
• Eigenschaften

Methoden

Die Win32_EncryptableVolume-Klasse verfügt über die folgenden Methoden.

Eigenschaften

Die Win32_EncryptableVolume-Klasse verfügt über die folgenden Eigenschaften.

ConversionStatus

Datentyp: uint32

Zugriffstyp: Schreibgeschützt

Eine ganze Zahl, die dem Verschlüsselungsstatus des Volumes entspricht. Dieser Wert wird gespeichert, wenn die Klasse instanziiert wird. Zwischen der Instanziierung und dem Zeitpunkt, zu dem Sie den Wert überprüfen, kann sich der Konvertierungsstatus ändern. Verwenden Sie die GetConversionStatus-Methode, um den Wert der ConversionStatus-Eigenschaft in Echtzeit zu überprüfen.

DeviceID

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Qualifizierer: Schlüssel

Ein eindeutiger Bezeichner für das Volume im System. Verwenden Sie diese Eigenschaft, um ein Volume anderen WMI-Anbieterklassen zuzuordnen, z. B. Win32_Volume.

DriveLetter

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Der Laufwerkbuchstabe des Volumes. Dieser Bezeichner kann verwendet werden, um ein Volume anderen WMI-Anbieterklassen zuzuordnen, z. B. Win32_Volume.

Für Volumes ohne Laufwerkbuchstaben ist dieser Wert NULL.

EncryptionMethod

Datentyp: uint32

Zugriffstyp: Schreibgeschützt

Eine ganze Zahl, die den Algorithmus identifiziert, der zum Verschlüsseln des Volumes verwendet wird.

IsVolumeInitializedForProtection

Datentyp: bool

Zugriffstyp: Schreibgeschützt

Gibt an, ob das Volume für den Start der Verschlüsselung bereit ist. Mindestens eine Schlüsselschutzvorrichtung muss hinzugefügt werden, bevor diese Eigenschaft „True“ lautet und die Verschlüsselung gestartet werden kann.

PersistentVolumeID

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Ein persistenter Bezeichner für das Volume im System. Dieser Bezeichner gilt ausschließlich für Win32_EncryptableVolume.

Dieser Bezeichner ist eine leere Zeichenfolge, wenn das Volume ein vollständig entschlüsseltes NTFS-Standardvolume ist. Andernfalls weist er einen eindeutigen Wert auf.

ProtectionStatus

Datentyp: uint32

Zugriffstyp: Schreibgeschützt

Der Status des Volumes, unabhängig davon, ob das Volume durch BitLocker geschützt wird. Dieser Wert wird gespeichert, wenn die Klasse instanziiert wird. Zwischen der Instanziierung und dem Zeitpunkt, zu dem Sie den Wert überprüfen, kann sich der Schutzstatus ändern. Verwenden Sie die GetProtectionStatus-Methode, um den Wert der ProtectionStatus-Eigenschaft in Echtzeit zu überprüfen.

VolumeType

Datentyp: uint32

Zugriffstyp: Schreibgeschützt

Eine ganze Zahl, die den Typ des Volumes identifiziert. Dieser Wert ist wichtig, damit bei der Verschlüsselung geeignete Schlüsselschutzvorrichtungen und Verschlüsselungsmethoden verwendet werden.

Sicherheitsüberlegungen

Die WMI-Anbieterklasse Win32_EncryptableVolume nutzt die Namespacesicherheit der Windows-Verwaltungsinstrumentation (Windows Management Instrumentation, WMI) und das Subsystem der BitLocker-Laufwerkverschlüsselung für die Zugriffssteuerung.

Um die Win32_EncryptableVolume-Methoden verwenden zu können, müssen die folgenden Bedingungen erfüllt sein:

• Sie müssen über Administratorrechte verfügen.

• Die Verbindungsverschlüsselung muss in der Lage sein, eine Verbindung mit dem Anbieter herzustellen.

  Weitere Informationen zum Erstellen einer verschlüsselten Verbindung finden Sie unter Anfordern einer verschlüsselten Verbindung mit einem Namespace.

Um Remoteverbindungen zuzulassen, muss WMI-Remotedatenverkehr zulässig sein. Weitere Informationen zum Zulassen von WMI-Datenverkehr finden Sie unter Einrichten einer WMI-Remoteverbindung (ab Windows Vista).

Die Standardeinstellung für die Namespacesicherheit enthält einen Eintrag, mit dem die Bearbeitung standardmäßig zugelassen werden kann. Weitere Informationen zur WMI-Namespaceüberwachung finden Sie unter Zugriff auf WMI-Namespaces.

Hinweise

MOF-Dateien (Managed Object Format) enthalten die Definitionen für WMI-Klassen. MOF-Dateien werden nicht als Teil des Windows SDK installiert. Sie werden auf dem Server installiert, wenn Sie die zugeordnete Rolle mit dem Server-Manager hinzufügen. Weitere Informationen zu MOF-Dateien finden Sie unter Managed Object Format (MOF).

Anforderungen