Win32_NTDomain

The Win32_NTDomain class represents a NT Domain. A domain is a single security boundary of a Windows NT computer network. Active Directory is made up of one or more domains. On a standalone workstation, the domain is the computer itself. A domain can span more than one physical location. Every domain has its own security policies and security relationships with other domains. When multiple domains are connected by trust relationships and share a common schema, configuration, and global catalog, you have a domain tree. Multiple domain trees can be connected together into a forest. All the domains in a forest also share a common schema, configuration, and global catalog.

Quick Start

Properties

Most WMI properties are read-only. You can only read values but not change them. Few properties are also writeable. You can assign new values to those properties.

Writeable properties are marked with this icon:   

Caption

Data type String

The Caption property is a short textual description (one-line string) of the object.

ClientSiteName

Data type String

The ClientSiteName property indicates the name of the site where the domain controller is configured to be in. This value may be NULL if the site that the computer named by ComputerName cannot be found (for example, if the DS administrator has not associated the subnet that the computer is in with a valid site).

CreationClassName

Data type String

The CreationClassName property indicates the name of the class or the subclass used in the creation of an instance. When used with the other key properties of this class, this property allows all instances of this class and its subclasses to be uniquely identified.

DcSiteName

Data type String

The DcSiteName property indicates the name of the site where the domain controller is located. This value may be NULL if the domain controller is not in a site (for example, the domain controller is a Windows NT 4.0 domain controller).

Description

Data type String

The Description property provides a textual description of the object.

DnsForestName

Data type String

The DnsForestName property indicates the name of the domain at the root of the DS tree. The DNS-style name (for example, microsoft.com.) will be returned if available.

DomainControllerAddress

Data type String

The DomainControllerAddress property indicates the address of the discovered domain controller.

DomainControllerAddressType

Data type SInt32

Indicates the type of address specified in DomainControllerAddress. The following valid values are presented in order, DS_INET_ADDRESS = Address is a string IP address (for example, \\157.55.94.74) of the domain controller. DS_NETBIOS_ADDRESS = The NetBIOS name (for example, \\phoenix) of the domain controller.

$DomainControllerAddressType_ReturnValue = 
@{
    1='DS_INET_ADDRESS'
    2='DS_NETBIOS_ADDRESS'
}

DomainControllerName

Data type String

The DomainControllerName property indicates the computer name of the discovered domain controller.

DomainGuid

Data type String

The GUID of the domain. This member will be zero if the domain controller does not have a Domain GUID (for example, the domain controller is not a Windows 2000 domain controller).

DomainName

Data type String

The DomainName property indicates the name of the domain. The DNS-style name (for example, microsoft.com.) will be returned if available.

DSDirectoryServiceFlag

Data type Boolean

Directory Service (DS) flag indicating that the domain controller is a directory service server for the domain.

DSDnsControllerFlag

Data type Boolean

Directory Service (DS) flag indicating that the Domain Controller Name is in DNS format (for example, www.mynode.com or 135.5.33.19).

DSDnsDomainFlag

Data type Boolean

Directory Service (DS) flag indicating that the DomainName is in DNS format(for example, www.mynode.com or 135.5.33.19).

DSDnsForestFlag

Data type Boolean

Directory Service (DS) flag indicating that the DnsForestName is in DNS format (for example, www.mynode.com or 135.5.33.19).

DSGlobalCatalogFlag

Data type Boolean

Directory Service (DS) flag indicating that the domain controller is a Global Catalog (GC) server for DnsForestName.

DSKerberosDistributionCenterFlag

Data type Boolean

Directory Service (DS) flag indicating that the domain controller is a Kerberos Key Distribution Center for the domain.

DSPrimaryDomainControllerFlag

Data type Boolean

Directory Service (DS) flag indicating that the domain controller is the Primary Domain Controller (PDC) of the domain.

DSTimeServiceFlag

Data type Boolean

Directory Service (DS) flag indicating that the domain controller is running the Windows Time service for the domain.

DSWritableFlag

Data type Boolean

Directory Service (DS) flag indicating that the domain controller hosts a write able DS or Security Accounts Manager (SAM).

InstallDate

Data type DateTime

The InstallDate property is datetime value indicating when the object was installed. A lack of a value does not indicate that the object is not installed.

Name

Data type String

The Name property defines the label by which the object is known. When subclassed, the Name property can be overridden to be a Key property.

NameFormat

Data type String

The CIM_System object and its derivatives are top level objects of CIM. They provide the scope for numerous components. Having unique system keys is required. A heuristic can be defined in individual system subclasses to attempt to always generate the same system name key. The NameFormat property identifies how the system name was generated, using the subclass’ heuristic.

PowerState

Data type UInt16

$PowerState_ReturnValue = 
@{
    1=
    2='(unknown)'
    3='(unknown)'
    4='(unknown)'
    5='(unknown)'
    6='(unknown)'
}

PrimaryOwnerContact

Data type String

A string that provides information on how the primary system owner can be reached (e.g. phone number, email address, …).

PrimaryOwnerName

Data type String

The name of the primary system owner.

  Roles

Data type String

An array (bag) of strings that specify the roles this System plays in the IT-environment. Subclasses of System may override this property to define explicit Roles values. Alternately, a Working Group may describe the heuristics, conventions and guidelines for specifying Roles. For example, for an instance of a networking system, the Roles property might contain the string, ‘Switch’ or ‘Bridge’.

Status

Data type String

The Status property is a string indicating the current status of the object. Various operational and non-operational statuses can be defined. Operational statuses are “OK”, “Degraded” and “Pred Fail”. “Pred Fail” indicates that an element may be functioning properly but predicting a failure in the near future. An example is a SMART-enabled hard drive. Non-operational statuses can also be specified. These are “Error”, “Starting”, “Stopping” and “Service”. The latter, “Service”, could apply during mirror-resilvering of a disk, reload of a user permissions list, or other administrative work. Not all such work is on-line, yet the managed element is neither “OK” nor in one of the other states.

'OK','Error','Degraded','Unknown','Pred Fail','Starting','Stopping','Service','Stressed','NonRecover','No Contact','Lost Comm'

Time

Data type DateTime

Methods

Examples

See Also

Help and Questions

  Community Content

You are cordially invited to add knowledge to this page. If you have sample code or additional information related to this WMI class, please share it. Use the comment form to send your information. We will edit and incorparate it into the reference library. Thank you!

Please do not use the comment form to submit questions. If you have questions or need assistance, visit our free forum: Help me with WMI.

Content last updated: 2013-12-27 12:09:15 (UTC).

Facebooktwittergoogle_pluspinterestlinkedinFacebooktwittergoogle_pluspinterestlinkedin