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 |