[Index]
Model ref.: device/exchangehybrid/MapiVirtualDirectory
The full URL would include the host-proxy name: https://[host-proxy].
Variables are enclosed in square brackets.
{ "$schema": "http://json-schema.org/draft-03/schema", "type": "object", "properties": { "WhenCreatedUTC": { "__type_requested": "System.DateTime", "__type_mapping_type": "DateTime", "name": "WhenCreatedUTC", "title": "WhenCreatedUTC", "format": "date-time", "required": false, "readonly": true, "type": "string" }, "OrganizationId": { "__type_requested": "System.String", "required": false, "name": "OrganizationId", "title": "OrganizationId", "__type_mapping_type": "String", "readonly": true, "type": "string" }, "Role": { "__type_requested": "ClientAccess | Mailbox", "__type_mapping_type": "Unknown", "description": "This parameter is reserved for internal Microsoft use.", "title": "Role", "required": false, "readonly": true, "__WARNING": "Unhandled and unknown upstream type, this attribute forced into a readonly string", "type": "string", "name": "Role" }, "AdminDisplayName": { "__type_requested": "System.String", "required": false, "name": "AdminDisplayName", "title": "AdminDisplayName", "__type_mapping_type": "String", "readonly": true, "type": "string" }, "PSShowComputerName": { "__type_requested": "System.Boolean", "required": false, "name": "PSShowComputerName", "title": "PSShowComputerName", "__type_mapping_type": "Boolean", "readonly": true, "type": "boolean" }, "ExternalAuthenticationMethods": { "__type_requested": "Deserialized.Microsoft.Exchange.Data.Directory.ADMultiValuedProperty`1[[Microsoft.Exchange.Data.Directory.SystemConfiguration.AuthenticationMethod,", "required": false, "name": "ExternalAuthenticationMethods", "title": "ExternalAuthenticationMethods", "__type_mapping_type": "Unknown", "readonly": true, "type": "string", "__WARNING": "Unhandled and unknown upstream type, this attribute forced into a readonly string" }, "ObjectClass": { "__type_requested": "Deserialized.Microsoft.Exchange.Data.MultiValuedProperty`1[[System.String,", "required": false, "name": "ObjectClass", "title": "ObjectClass", "items": { "type": "string" }, "__type_mapping_type": "String[]", "readonly": true, "type": "array" }, "PSComputerName": { "__type_requested": "System.String", "required": false, "name": "PSComputerName", "title": "PSComputerName", "__type_mapping_type": "String", "readonly": true, "type": "string" }, "ExtendedProtectionTokenChecking": { "__type_requested": "System.String", "__type_mapping_type": "String", "description": "This parameter is reserved for internal Microsoft use.", "title": "ExtendedProtectionTokenChecking", "required": false, "readonly": false, "type": "string", "name": "ExtendedProtectionTokenChecking" }, "Path": { "__type_requested": "System.String", "required": false, "name": "Path", "title": "Path", "__type_mapping_type": "String", "readonly": true, "type": "string" }, "Identity": { "__type_requested": "System.String", "required": false, "name": "Identity", "title": "Identity", "__type_mapping_type": "String", "readonly": true, "type": "string", "description": "The Identity parameter specifies the MAPI virtual directory that you want to view.\nYou can use any value that uniquely identifies the virtual directory. For example:\nName or <Server>\\Name\nDistinguished name (DN)\nGUID\nThe Name value uses the syntax \"<VirtualDirectoryName> (<WebsiteName>)\" from the properties of the virtual directory. You can specify the wildcard character (*) instead of the default website by using the syntax <VirtualDirectoryName>*." }, "DistinguishedName": { "__type_requested": "System.String", "required": false, "name": "DistinguishedName", "title": "DistinguishedName", "__type_mapping_type": "String", "readonly": true, "type": "string" }, "OriginatingServer": { "__type_requested": "System.String", "required": false, "name": "OriginatingServer", "title": "OriginatingServer", "__type_mapping_type": "String", "readonly": true, "type": "string" }, "Name": { "__type_requested": "System.String", "required": false, "name": "Name", "title": "Name", "__type_mapping_type": "String", "readonly": true, "type": "string", "description": "This parameter is reserved for internal Microsoft use." }, "Server": { "__type_requested": "System.String", "__type_mapping_type": "String", "description": "The Server parameter specifies the Exchange server that will host the virtual directory. You can use any value that uniquely identifies the server. For example:\nName\nFQDN\nDistinguished name (DN)\nExchange Legacy DN\nIf you don't use the Server parameter, the virtual directory will be created on the server where the remote PowerShell session is established. This will always be a Mailbox server. If you want to create the virtual directory on a Client Access server or another Mailbox server, you need to use the Server parameter.", "title": "Server", "required": false, "readonly": false, "type": "string", "name": "Server" }, "WhenCreated": { "__type_requested": "System.DateTime", "__type_mapping_type": "DateTime", "name": "WhenCreated", "title": "WhenCreated", "format": "date-time", "required": false, "readonly": true, "type": "string" }, "InternalAuthenticationMethods": { "__type_requested": "Deserialized.Microsoft.Exchange.Data.Directory.ADMultiValuedProperty`1[[Microsoft.Exchange.Data.Directory.SystemConfiguration.AuthenticationMethod,", "required": false, "name": "InternalAuthenticationMethods", "title": "InternalAuthenticationMethods", "__type_mapping_type": "Unknown", "readonly": true, "type": "string", "__WARNING": "Unhandled and unknown upstream type, this attribute forced into a readonly string" }, "AdminDisplayVersion": { "__type_requested": "System.String", "required": false, "name": "AdminDisplayVersion", "title": "AdminDisplayVersion", "__type_mapping_type": "String", "readonly": true, "type": "string" }, "MetabasePath": { "__type_requested": "System.String", "required": false, "name": "MetabasePath", "title": "MetabasePath", "__type_mapping_type": "String", "readonly": true, "type": "string" }, "ExchangeVersion": { "__type_requested": "System.String", "required": false, "name": "ExchangeVersion", "title": "ExchangeVersion", "__type_mapping_type": "String", "readonly": true, "type": "string" }, "ExternalUrl": { "__type_requested": "", "__type_mapping_type": "Unknown", "description": "The ExternalURL parameter specifies the URL that's used to connect to the virtual directory from outside the firewall.\nThis setting enforces the Secure Sockets Layer (SSL) protocol and uses the default SSL port. Valid input for this parameter uses the syntax https://<Domain Name>/mapi.\nWhen you use the InternalUrl or ExternalUrl parameters, you need to specify one or more authentication values by using the IISAuthenticationMethods parameter.", "title": "ExternalUrl", "required": false, "readonly": true, "__WARNING": "Unhandled and unknown upstream type, this attribute forced into a readonly string", "type": "string", "name": "ExternalUrl" }, "InternalUrl": { "__type_requested": "System.Uri", "__type_mapping_type": "Unknown", "description": "The InternalURL parameter specifies the URL that's used to connect to the virtual directory from inside the firewall.\nThis setting enforces the Secure Sockets Layer (SSL) protocol and uses the default SSL port. Valid input for this parameter uses the syntax https://<Domain Name>/mapi.\nWhen you use the InternalUrl or ExternalUrl parameters, you need to specify one or more authentication values by using the IISAuthenticationMethods parameter.", "title": "InternalUrl", "required": false, "readonly": true, "__WARNING": "Unhandled and unknown upstream type, this attribute forced into a readonly string", "type": "string", "name": "InternalUrl" }, "DomainController": { "__type_requested": "Fqdn", "__type_mapping_type": "String", "description": "The DomainController parameter specifies the fully qualified domain name (FQDN) of the domain controller that writes this configuration change to Active Directory.", "title": "DomainController", "required": false, "readonly": false, "type": "string", "name": "DomainController" }, "ObjectCategory": { "__type_requested": "System.String", "required": false, "name": "ObjectCategory", "title": "ObjectCategory", "__type_mapping_type": "String", "readonly": true, "type": "string" }, "IsValid": { "__type_requested": "System.Boolean", "required": false, "name": "IsValid", "title": "IsValid", "__type_mapping_type": "Boolean", "readonly": true, "type": "boolean" }, "ExtendedProtectionFlags": { "__type_requested": "MultiValuedProperty", "__type_mapping_type": "String[]", "description": "This parameter is reserved for internal Microsoft use.", "title": "ExtendedProtectionFlags", "items": { "type": "string" }, "required": false, "readonly": false, "type": "array", "name": "ExtendedProtectionFlags" }, "WhenChanged": { "__type_requested": "System.DateTime", "__type_mapping_type": "DateTime", "name": "WhenChanged", "title": "WhenChanged", "format": "date-time", "required": false, "readonly": true, "type": "string" }, "WhenChangedUTC": { "__type_requested": "System.DateTime", "__type_mapping_type": "DateTime", "name": "WhenChangedUTC", "title": "WhenChangedUTC", "format": "date-time", "required": false, "readonly": true, "type": "string" }, "ObjectState": { "__type_requested": "System.String", "required": false, "name": "ObjectState", "title": "ObjectState", "__type_mapping_type": "String", "readonly": true, "type": "string" }, "ExtendedProtectionSPNList": { "__type_requested": "MultiValuedProperty", "__type_mapping_type": "String[]", "description": "This parameter is reserved for internal Microsoft use.", "title": "ExtendedProtectionSPNList", "items": { "type": "string" }, "required": false, "readonly": false, "type": "array", "name": "ExtendedProtectionSPNList" }, "IISAuthenticationMethods": { "__type_requested": "MultiValuedProperty", "__type_mapping_type": "String[]", "description": "The IISAuthenticationMethods parameter specifies the authentication methods that are enabled on the virtual directory in Internet Information Services (IIS). Valid values for this parameter are:\nBasic\nNegotiate\nNTLM\nYou can specify multiple values separated by commas.", "title": "IISAuthenticationMethods", "items": { "type": "string" }, "required": false, "readonly": false, "type": "array", "name": "IISAuthenticationMethods" }, "RunspaceId": { "__type_requested": "System.Guid", "required": false, "name": "RunspaceId", "title": "RunspaceId", "__type_mapping_type": "String", "readonly": true, "type": "string" }, "Guid": { "__type_requested": "System.Guid", "required": false, "name": "Guid", "title": "Guid", "__type_mapping_type": "String", "readonly": true, "type": "string" }, "Id": { "__type_requested": "System.String", "required": false, "name": "Id", "title": "Id", "__type_mapping_type": "String", "readonly": true, "type": "string" } }, "schema_version": "15312" }
Task | Call | URL | Parameters | Response |
---|---|---|---|---|
Get the GUI Add form. | GET | /api/device/exchangehybrid/MapiVirtualDirectory/add/ |
|
The GUI Add form of device/exchangehybrid/MapiVirtualDirectory as JSON |
The API call to the /add/ URL can only be made from a hierarchy that allows the model type to be added. The actions in the response shows the url for the POST API call to create an instance.
Task | Call | URL | Parameters | Payload |
---|---|---|---|---|
Create | POST | /api/device/exchangehybrid/MapiVirtualDirectory | hierarchy=[hierarchy] |
|
tool/Transaction/[trans pkid]to inspect the created resource and its instance pkid.
Task | Call | URL | Parameters | Payload |
---|---|---|---|---|
Bulk delete [pkid1],[pkid2]... | DELETE | /api/device/exchangehybrid/MapiVirtualDirectory/ | hierarchy=[hierarchy] | {"hrefs":["/api/device/exchangehybrid/MapiVirtualDirectory/[pkid1]", "/api/device/exchangehybrid/MapiVirtualDirectory/[pkid2]", ...]} |
GET http://[host-proxy]/api/device/exchangehybrid/MapiVirtualDirectory/?hierarchy=[hierarchy]&format=json
Task | Call | URL | Parameters | Response |
---|---|---|---|---|
Bulk Modify | GET | /api/device/exchangehybrid/MapiVirtualDirectory/bulk_update/?schema=&schema_rules=true |
|
|
Task | Call | URL | Parameters | Payload |
---|---|---|---|---|
Bulk Modify | POST | /api/device/exchangehybrid/MapiVirtualDirectory/bulk_update/ |
|
For example: {"data":{"name":"value"}, "meta":{}, "request_meta":{ "hrefs":["/api/v0/device/exchangehybrid/MapiVirtualDirectory/[pkid1]", "/api/v0/device/exchangehybrid/MapiVirtualDirectory/[pkid2]",...]}} |
GET http://[host-proxy]/api/device/exchangehybrid/MapiVirtualDirectory/?hierarchy=[hierarchy]&format=json
Task | Call | URL | Parameters | Payload |
---|---|---|---|---|
Move the instance with [pkid] to [target_hierarchy] | POST | /api/tool/DataMove/?model_type=device/exchangehybrid/MapiVirtualDirectory |
|
{"hrefs": ["/api/device/exchangehybrid/MapiVirtualDirectory/[pkid]"]} |
Bulk Move | POST | /api/tool/DataMove/?model_type=device/exchangehybrid/MapiVirtualDirectory |
|
{"hrefs": ["/api/device/exchangehybrid/MapiVirtualDirectory/[pkid1]", "/api/device/exchangehybrid/MapiVirtualDirectory/[pkid2]",...]} |
Task | Call | URL | Parameters | Payload |
---|---|---|---|---|
Get a selected [export_format] of the schema and instances [pkid1], [pkid2],... of device/exchangehybrid/MapiVirtualDirectory; optionally with tag_version at [version] and Configuration Template as [configtemplate]. | POST | /api/device/exchangehybrid/MapiVirtualDirectory/export/ |
|
{ "hrefs":["/api/device/exchangehybrid/MapiVirtualDirectory/[pkid1]", "/api/device/exchangehybrid/MapiVirtualDirectory/[pkid2]",...]}} |
For export_format=json, the response is a time stamped zip file of data in JSON as in the system database. Item properties such as strings that are empty or Boolean values that are not set, are not included. The filename in the response is of the format as the example:
Content-Disposition: attachment; filename=export_2013-05-17_14:20:19.186444.json.zip Content-Language:en Content-Type:application/x-zip
For export_format=raw_xlsx, the response is a MS Excel spreadsheet with columns corresponding to the JSON format export and a response filename format:
Content-Disposition: attachment; filename=<resource_type>_<resource_name>_exportedsheet_CCYY-MM-DD_HH-MM-SS.xlsx Content-Language:en Content-Type:application/vnd.openxmlformats-officedocument.spreadsheetml.sheet
For export_format=xlsx, the response is a MS Excel spreadsheet, arranged by any Field Display Policies that apply. The columns correspond with those of a Bulk Load Template export sheet. The response filename format is:
Content-Disposition: attachment; filename=<resource_type>_<resource_name>_exportedsheet_formatted_CCYY-MM-DD_HH-MM-SS.xlsx Content-Language:en Content-Type:application/vnd.openxmlformats-officedocument.spreadsheetml.sheet
The XLSX format can be used to bulk load instances of device/exchangehybrid/MapiVirtualDirectory and the JSON format can be used to import instances of device/exchangehybrid/MapiVirtualDirectory.
GET http://[host-proxy]/api/device/exchangehybrid/MapiVirtualDirectory/?hierarchy=[hierarchy]
Task | Call | URL | Parameters | Response |
---|---|---|---|---|
Get a compressed format of the Bulk Load spreadsheet template for device/exchangehybrid/MapiVirtualDirectory | POST | /api/device/exchangehybrid/MapiVirtualDirectory/export_bulkload_template/ |
|
The response is an attachment of the format: filetype_bulkloadsheet.xlsx.gz |
Task | Call | URL | Parameters | Response |
---|---|---|---|---|
Configuration Template | GET | /api/device/exchangehybrid/MapiVirtualDirectory/configuration_template/ | hierarchy=[hierarchy] |
|
POST http://[host-proxy]/api/data/ConfigurationTemplate/?hierarchy=[hierarchy]
Task | Call | URL | Parameters | Response |
---|---|---|---|---|
Field Display Policy | GET | /api/device/exchangehybrid/MapiVirtualDirectory/field_display_policy/ | hierarchy=[hierarchy] |
|
POST http://[host-proxy]/api/data/FieldDisplayPolicy/?hierarchy=[hierarchy]
Task | Call | URL | Parameters | Response |
---|---|---|---|---|
List | GET | /api/device/exchangehybrid/MapiVirtualDirectory/ |
|
The device/exchangehybrid/MapiVirtualDirectory schema and all instances as JSON. |
(The list will return 0 to 3 device/exchangehybrid/MapiVirtualDirectory instances)
{ "pagination": { "skip": 0, "limit": 3, "maximum_limit": 2000, "total": 0, "total_limit": null, "order_by": null, "direction": "asc", "current": "/api/device/exchangehybrid/MapiVirtualDirectory/?skip=0&limit=3&order_by=None&direction=asc&traversal=down" }, "operations": [ "move" ], "meta": { "model_type": "device/exchangehybrid/MapiVirtualDirectory", "summary_attrs": [ { "name": "hierarchy_friendly_name", "title": "Located At", "allow_filtering": true } ], "tagged_versions": [], "tags": [], "title": "", "business_key": {}, "api_version": "21.2", "cached": true, "references": { "children": [], "parent": [ { "href": "/api/data/HierarchyNode/6t0ggef2c0deab00hb595101", "pkid": "6t0ggef2c0deab00hb595101" } ], "device": [ { "href": "", "pkid": "" } ], "foreign_key": [] }, "model_specific_actions": [ "get", "list", "add", "remove", "update", "bulk_update_form", "clone", "configuration_template", "export", "export_bulkload_template", "field_display_policy", "help", "move" ], "schema_version": "15312", "actions": [ { "add": { "method": "GET", "class": "add", "href": "/api/device/exchangehybrid/MapiVirtualDirectory/add/?hierarchy=[hierarchy]", "support_async": false, "title": "Add" } }, { "remove": { "method": "DELETE", "class": "delete", "href": "/api/device/exchangehybrid/MapiVirtualDirectory/?hierarchy=[hierarchy]", "support_async": true, "title": "Delete" } }, { "bulk_update_form": { "method": "GET", "class": "update", "href": "/api/device/exchangehybrid/MapiVirtualDirectory/bulk_update/?hierarchy=[hierarchy]&schema=&schema_rules=true", "support_async": false, "title": "Bulk Modify" } }, { "move": { "method": "POST", "class": "move", "href": "/api/tool/DataMove/?hierarchy=[hierarchy]&model_type=device/exchangehybrid/MapiVirtualDirectory", "support_async": true, "title": "Move", "view": "/api/tool/DataMove/?auth_token=[authtoken] } }, { "export": { "method": "POST", "class": "export", "href": "/api/device/exchangehybrid/MapiVirtualDirectory/export/?hierarchy=[hierarchy]", "support_async": false, "title": "Export", "view": "/api/view/ExportData/add/?auth_token=[authtoken], "submit": "payload" } }, { "export_bulkload_template": { "method": "POST", "class": "bulkload_template", "href": "/api/device/exchangehybrid/MapiVirtualDirectory/export_bulkload_template/?hierarchy=[hierarchy]", "support_async": false, "title": "Export Bulk Load Template" } }, { "configuration_template": { "method": "GET", "class": "config", "href": "/api/device/exchangehybrid/MapiVirtualDirectory/configuration_template/?hierarchy=[hierarchy]", "support_async": false, "title": "Configuration Template" } }, { "field_display_policy": { "method": "GET", "class": "display_policy", "href": "/api/device/exchangehybrid/MapiVirtualDirectory/field_display_policy/?hierarchy=[hierarchy]", "support_async": false, "title": "Field Display Policy" } }, { "list": { "method": "GET", "class": "list", "href": "/api/device/exchangehybrid/MapiVirtualDirectory/?hierarchy=[hierarchy]", "support_async": false, "title": "List" } }, { "help": { "method": "GET", "class": "help", "href": "/api/device/exchangehybrid/MapiVirtualDirectory/help?hierarchy=[hierarchy]", "support_async": false, "title": "Help" } }, { "purge": { "method": "POST", "class": "purge", "href": "/api/device/exchangehybrid/MapiVirtualDirectory/purge/?hierarchy=[hierarchy]", "support_async": false, "title": "Purge" } } ] }, "resources": [] }
Task | Call | URL | Parameters | Response |
---|---|---|---|---|
Get the on-line Help for device/exchangehybrid/MapiVirtualDirectory. | GET | /api/device/exchangehybrid/MapiVirtualDirectory/help | hierarchy=[hierarchy] | On-line help of Model ref.: device/exchangehybrid/MapiVirtualDirectory as HTML |
Task | Call | URL | Parameters | Response |
---|---|---|---|---|
Purge | POST | /api/device/exchangehybrid/MapiVirtualDirectory/purge/ |
|
Task | Call | URL | Parameters | Payload |
---|---|---|---|---|
Modify | PUT | /api/device/exchangehybrid/MapiVirtualDirectory/[pkid] | hierarchy=[hierarchy] | (For payload specification) |
For Bulk modification, refer to the Bulk Modify section.
Task | Call | URL | Parameters | Response |
---|---|---|---|---|
Delete | DELETE | /api/device/exchangehybrid/MapiVirtualDirectory/[pkid] | hierarchy=[hierarchy] |
Task | Call | URL | Parameters | Response |
---|---|---|---|---|
Clone instance with [pkid]. The schema rules are applied. | GET | /api/device/exchangehybrid/MapiVirtualDirectory/[pkid]/clone/?schema=&schema_rules=true |
|
A JSON payload with:
|
GET http://[host-proxy]/api/device/exchangehybrid/MapiVirtualDirectory/?hierarchy=[hierarchy]&format=json
Task | Call | URL | Parameters | Payload |
---|---|---|---|---|
Move | POST | /api/tool/DataMove/[pkid]/?model_type=device/exchangehybrid/MapiVirtualDirectory | hierarchy=[hierarchy] | If payload required: |
Task | Call | URL | Parameters | Response |
---|---|---|---|---|
Get a selected [export_format] of the schema and a single instance with [pkid] of device/exchangehybrid/MapiVirtualDirectory; optionally with tag_version at [version] and Configuration Template as [configtemplate]. | GET | /api/device/exchangehybrid/MapiVirtualDirectory/[pkid]/export |
|
The response is an attachment. Refer to the list below. |
For export_format=raw_xlsx, the response is a "raw" MS Excel spreadsheet with columns corresponding to the JSON format export and a response format:
Content-Disposition: attachment; filename=<resource_type>_<resource_name>_exportedsheet_CCYY-MM-DD_HH-MM-SS.xlsx Content-Language:en Content-Type:application/vnd.openxmlformats-officedocument.spreadsheetml.sheet
For export_format=xlsx, the response is a MS Excel spreadsheet, formatted to show all columns and a response format:
Content-Disposition: attachment; filename=<resource_type>_<resource_name>_exportedsheet_formatted_CCYY-MM-DD_HH-MM-SS.xlsx Content-Language:en Content-Type:application/vnd.openxmlformats-officedocument.spreadsheetml.sheet
For export_format=json, the response is a time stamped zip file of data in JSON and a response format:
Content-Disposition: attachment; filename=export_2013-05-17_14:20:19.186444.json.zip Content-Language:en Content-Type:application/x-zip
The XLSX format can be used to bulk load instances of device/exchangehybrid/MapiVirtualDirectory and the JSON format can be used to import instances of device/exchangehybrid/MapiVirtualDirectory.
For Bulk Export, refer to the Bulk Export section.
Task | Call | URL | Parameters | Response |
---|---|---|---|---|
Get | GET | /api/device/exchangehybrid/MapiVirtualDirectory/[pkid] | hierarchy=[hierarchy] | The device/exchangehybrid/MapiVirtualDirectory instance with [pkid]. |
Task | Call | URL | Parameters | Response |
---|---|---|---|---|
Help | GET | /api/device/exchangehybrid/MapiVirtualDirectory/[pkid]/help | hierarchy=[hierarchy] | The on-line Help for device/exchangehybrid/MapiVirtualDirectory. |
Task | Call | URL | Parameters | Payload |
---|---|---|---|---|
Purge | POST | /api/device/exchangehybrid/MapiVirtualDirectory/[pkid]/purge | hierarchy=[hierarchy] | If payload required: |