11/11/2008

The Get-EnrollmentRequestcmdlet 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-EnrollmentRequestcmdlet without parameters, the cmdlet returns all pending enrollment requests.

Syntax 

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

Parameters

The following describes the Get-EnrollmentRequestcmdlet parameters.

Name <String>

Specifies the distinguished name, Domain Name System (DNS) host name, or the common name of the device.

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.

EnrollmentId <String>

Specifies an identity string that is used to enroll the device.

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), SCMDM2008 Managed Devices.

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-EnrollmentRequestcmdlet 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-EnrollmentRequestcmdlet returns a collection of EnrollmentRequestobjects. To see all the properties for this object, at the Mobile Device Manager (MDM) Shell prompt, type Get-EnrollmentRequest | Get-Member.

Examples

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

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

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

Copy Code 
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