Get-UalSystemId

Gets information that can uniquely identify a server.

Syntax

Get-UalSystemId
   [-PhysicalProcessorCount <UInt32[]>]
   [-CoresPerPhysicalProcessor <UInt32[]>]
   [-LogicalProcessorsPerPhysicalProcessor <UInt32[]>]
   [-OSMajor <UInt32[]>]
   [-OSMinor <UInt32[]>]
   [-OSBuildNumber <UInt32[]>]
   [-OSPlatformId <UInt32[]>]
   [-ServicePackMajor <UInt32[]>]
   [-ServicePackMinor <UInt32[]>]
   [-OSSuiteMask <UInt32[]>]
   [-OSProductType <UInt32[]>]
   [-OSSerialNumber <String[]>]
   [-OSCountryCode <String[]>]
   [-OSCurrentTimeZone <Int16[]>]
   [-OSDaylightInEffect <Boolean[]>]
   [-OSLastBootUpTime <DateTime[]>]
   [-MaximumMemory <UInt64[]>]
   [-SystemSMBIOSUUID <String[]>]
   [-SystemSerialNumber <String[]>]
   [-SystemDNSHostName <String[]>]
   [-SystemDomainName <String[]>]
   [-CreationTime <DateTime[]>]
   [-SystemManufacturer <String[]>]
   [-SystemProductName <String[]>]
   [-CimSession <CimSession[]>]
   [-ThrottleLimit <Int32>]
   [-AsJob]
   [<CommonParameters>]

Description

The Get-UalSystemId cmdlet gets information that can uniquely identify a server. Use the CimSession parameter to run the cmdlet on a remote server. Otherwise, the cmdlet refers to the local server.

This cmdlet returns an MsftUal_SystemId object. You can specify one or more parameters, such as the CoresPerPhysicalProcessor parameter. If you do so, the cmdlet only returns an object if it matches the specified value.

Examples

Example 1: Get system information

PS C:\>Get-UalSystemId

This command gets an MsftUal_SystemId object for the current system.

Parameters

-AsJob

Runs the cmdlet as a background job. Use this parameter to run commands that take a long time to complete.

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

-CimSession

Runs the cmdlet in a remote session or on a remote computer. Enter a computer name or a session object, such as the output of a New-CimSession or Get-CimSession cmdlet. The default is the current session on the local computer.

Type:CimSession[]
Aliases:Session
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-CoresPerPhysicalProcessor

Specifies an array of values. Each value specifies the number of cores for the physical processor of the system.

Type:UInt32[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-CreationTime

Specifies an array of DateTime objects. Each object is the date and time that the current operating system became operational with this set of system identity properties. If the properties of a system change, the operating system creates a new MsftUal_SystemId object.

Type:DateTime[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-LogicalProcessorsPerPhysicalProcessor

Specifies an array of values. Each value specifies the number of logical processors for an instance of a Hyper-Thread capable physical processor in the system.

Type:UInt32[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-MaximumMemory

Specifies an array of values. Each value represents the maximum memory size, in bytes, for the system. For a virtual machine, this value represents the memory size of the virtual machine as configured by the hypervisor.

Type:UInt64[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-OSBuildNumber

Specifies an array of values. Each value represents the build number for the operating system.

Type:UInt32[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-OSCountryCode

Specifies an array of strings. Each value is a code for the country or region that an operating system uses, based on international phone prefixes.

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

-OSCurrentTimeZone

Specifies an array of values. Each value represents an offset, in minutes, between the operating system time and Greenwich Mean Time (GMT). The value can be positive, negative, or zero.

Type:Int16[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-OSDaylightInEffect

Specifies an array of Boolean values. If a value is $True, daylight saving time is in effect.

Type:Boolean[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-OSLastBootUpTime

Specifies an array of DateTime objects. A value represents the last time the operating system was restarted.

Type:DateTime[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-OSMajor

Specifies an array of values. Each value represents the major portion of the version number of an operating system.

Type:UInt32[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-OSMinor

Specifies an array of values. Each value represents the minor portion of the version number of an operating system.

Type:UInt32[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-OSPlatformId

Specifies an array of values. Each value represents an operating system platform. The acceptable values for this parameter are:

  • 1 - An unsupported Windows system.
  • 2 - A supported Windows system.
Type:UInt32[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-OSProductType

Specifies an array of values. Each value represents an operating system product type. The acceptable values for this parameter are:

  • 1 - Standard Edition of a server product.
  • 2 - Enterprise Edition of a server product.
Type:UInt32[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-OSSerialNumber

Specifies an array of strings. Each string is an operating system product serial number.

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

-OSSuiteMask

Specifies an array of values. Each value represents the suite mask for an system. A suite mask is a combination of bit flags that identify the product suites available on the system.

Type:UInt32[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-PhysicalProcessorCount

Specifies an array of values. Each value represents the number of physical processors available on the local system. This number does not include the disabled processors.

Type:UInt32[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ServicePackMajor

Specifies an array of values. Each value represents the major portion of the version number of a service pack.

Type:UInt32[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ServicePackMinor

Specifies an array of values. Each value represents the minor portion of the version number of a service pack.

Type:UInt32[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-SystemDNSHostName

Specifies an array of strings. Each string is a server name according to the Domain Name System (DNS) server.

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

-SystemDomainName

Specifies an array of strings. Each sting is the name of the domain or workgroup that the server belongs to.

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

-SystemManufacturer

Specifies an array of strings. Each string represents the name of the BIOS manufacturer.

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

-SystemProductName

Specifies an array of strings. Each string represents the product name specified in the system BIOS.

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

-SystemSerialNumber

Specifies an array of strings. Each string represents a unit identification for a server.

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

-SystemSMBIOSUUID

Specifies an array of strings. Each string represents the universally unique identifier (UUID) for this server unit as reported by the SMBIOS.

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

-ThrottleLimit

Specifies the maximum number of concurrent operations that can be established to run the cmdlet. If this parameter is omitted or a value of 0 is entered, then Windows PowerShell® calculates an optimum throttle limit for the cmdlet based on the number of CIM cmdlets that are running on the computer. The throttle limit applies only to the current cmdlet, not to the session or to the computer.

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