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.
|If you do not specify either the Nameor Containerparameter with this cmdlet, then the Containerproperty of the EnrollmentRequestobjects that are returned will be empty. If you do specify the Nameor Containerparameter, then the Containerproperty is returned with the name of the Active Directory container to which the device belongs.|
Get-EnrollmentRequest [[-Name] <string>] [-Container <ContainerIdParameter>] [-EnrollmentId <string>] [-IncludePassword] [-Owner <AdUserParameter>] [<CommonParameters>]
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. 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.
Specifies that the enrollment password is to be displayed along with the enrollment request. By default, the enrollment password is not displayed.
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.
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.
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.
This Get-EnrollmentRequestcommand example displays all pending enrollment requests for the owner, Mikael Sandberg.
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.
C:\PS>Get-EnrollmentRequest -Container yourOU -IncludePassword
To view this information online, at the MDM Shell prompt, type:
get-help Get-EnrollmentRequest -detailed, or get-help Get-EnrollmentRequest -full