Get-EnrollmentRequest

2/9/2009

The Get-EnrollmentRequest cmdlet returns pending Windows Mobile device enrollment requests.

You can determine specific enrollment requests by device, owner, enrollment ID, or Active Directory container. If you call the Get-EnrollmentRequest cmdlet without parameters, the cmdlet returns all pending enrollment requests.

Note

If you do not specify either the Name or Container parameter with this cmdlet, then the Container property of the EnrollmentRequest objects that are returned will be empty. If you do specify the Name or Container parameter, then the Container property is returned with the name of the Active Directory container to which the device belongs.

Syntax

Get-EnrollmentRequest [[-Name] <string>] [-Container <ContainerIdParameter>] [-EnrollmentId <string>] [-IncludePassword] [-Owner <AdUserParameter>] [<CommonParameters>]

Parameters

The following describes the Get-EnrollmentRequest cmdlet parameters.

  • Name <String>
    Specifies the distinguished name, Domain Name System (DNS) host name, or the common name of the device. If the value contains a space or other special characters, enclose the string in quotation marks.
  • Owner <AdUserParameter>
    Specifies the common name, e-mail address, distinguished name, security ID (SID), or Logon ID of the device owner. This owner must exist in Active Directory. You cannot specify Anonymous as the owner. If the value contains a space or other special characters, enclose the string in quotation marks.
  • Container <ContainerIdParameter>
    Specifies the container in Active Directory for the device. You do not need to specify this parameter if you are using the default organizational unit (OU), SCMDM Managed Devices (<instance name>). If the value contains a space or other special characters, enclose the string in quotation marks.
  • EnrollmentId <String>
    Specifies an identity string that is used to enroll the device.
  • IncludePassword
    Specifies that the enrollment password is to be displayed along with the enrollment request. By default, the enrollment password is not displayed.
  • CommonParameters
    This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, and -OutVariable. For more information, at the MDM Shell prompt, type, get-help about_commonparameters.

Input Type

The Get-EnrollmentRequest cmdlet accepts a string through the pipeline that identifies a device, or an object that has the properties name, owner, enrollmentId, container, or includePassword.

Output Type

The Get-EnrollmentRequest cmdlet returns a collection of EnrollmentRequest objects. To see all the properties for this object, at the Mobile Device Manager (MDM) Shell prompt, type Get-EnrollmentRequest | Get-Member.

Examples

This Get-EnrollmentRequest command example displays all pending enrollment requests for the owner, Mikael Sandberg.

C:\PS>Get-EnrollmentRequest -Owner "Mikael Sandberg"

This Get-EnrollmentRequest command example displays all pending enrollment requests for devices in the Active Directory container, yourOU. The enrollment password values are displayed.

C:\PS>Get-EnrollmentRequest -Container yourOU -IncludePassword

Cmdlet Help

To view this information online, at the MDM Shell prompt, type:

get-help Get-EnrollmentRequest -detailed, or get-help Get-EnrollmentRequest -full

See Also

Reference

New-EnrollmentRequest
Remove-EnrollmentRequest