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