Add-BlockedDevice

2/9/2009

The Add-BlockedDevice cmdlet adds a compromised managed Windows Mobile device to the blocked device list.

A blocked managed device cannot establish a virtual private network (VPN) connection with Mobile Device Manager Gateway Server until you remove the managed device from the block list, or you enroll it with a new certificate.

Syntax

Add-BlockedDevice [-DeviceId] <DeviceIdParameter> [-confirm] [-whatif] [<CommonParameters>]

Add-BlockedDevice -Owner <OwnerIdParameter> [-confirm] [-whatif] [<CommonParameters>]

Parameters

The following describes the Add-BlockedDevice cmdlet parameters.

  • DeviceId <DeviceIdParameter>
    Specifies the identity of the managed device to be blocked. This parameter can be a device common name, the distinguished name, the fully qualified domain name (FQDN), or the security ID (SID). If the value contains a space or other special characters, enclose the string in quotation marks.
  • Owner <OwnerIdParameter>
    Identifies the managed device to be blocked based on the device owner. If more than one device is found for this owner, an error is returned. This parameter can be a common name, e-mail address, distinguished name, SID, or Logon ID. If the value contains a space or other special characters, enclose the string in quotation marks.
  • WhatIf
    Informs you of what changes would be made if the action were to be performed (the cmdlet is not executed).
  • Confirm
    Prompts you for confirmation before the cmdlet executes.
  • 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 Add-BlockedDevice cmdlet accepts a string through the pipeline that identifies a managed device, or an object that has the deviceId property.

Output Type

The Add-BlockedDevice cmdlet returns a collection of BlockedDevice objects that represent the currently blocked managed devices. To see all the properties for this object, at the MDM Shell prompt, type Get-BlockedDevice | Get-Member.

Examples

This Add-BlockedDevice command example blocks the managed device, device1.

C:\PS>Add-BlockedDevice -Identity device1

This Add-BlockedDevice command example blocks the enrolled managed device owned by Mikael Sandberg.

C:\PS>Add-BlockedDevice -Owner "Mikael Sandberg"

Cmdlet Help

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

get-help Add-BlockedDevice -detailed, or get-help Add-BlockedDevice -full

See Also

Reference

Get-BlockedDevice
Remove-BlockedDevice