extensionAlternateVersionsArray.hide.windowsExtensions object

2025-10-30

Configures how to hide Windows-only types of extensions in favor of Office Web Add-in versions that run cross-platform (for example in Office on the web or Mac). For more information, see Option to disable Windows-only add-ins in the Office Add-ins documentation.

Properties that reference this object type:

root.extensions.alternates.hide.windowsExtensions

{
  "effect": "userOptionToDisable | disableWithNotification",
  "comAddin": {
    "progIds": [
      "{string}"
    ]
  },
  "automationAddin": {
    "progIds": [
      "{string}"
    ]
  },
  "xllCustomFunctions": {
    "fileNames": [
      "{string}"
    ]
  }
}

{
  "type": "object",
  "description": "Configures how to hide windows native extensions",
  "properties": {
    "effect": {
      "type": "string",
      "description": "Specifies the effect to take while installing the web add-in if the equivalent add-in is installed.",
      "enum": [
        "userOptionToDisable",
        "disableWithNotification"
      ]
    },
    "comAddin": {
      "type": "object",
      "description": "Specifies the equivalent COM or VSTO add-ins",
      "properties": {
        "progIds": {
          "type": "array",
          "description": "Specifies the program Ids of the equivalent COM add-ins and the names of equivalent VSTO add-ins",
          "minItems": 1,
          "maxItems": 5,
          "items": {
            "type": "string",
            "minLength": 1,
            "maxLength": 64
          }
        }
      },
      "additionalProperties": false,
      "required": [
        "progIds"
      ]
    },
    "automationAddin": {
      "type": "object",
      "description": "Specifies the equivalent automation add-ins",
      "properties": {
        "progIds": {
          "type": "array",
          "description": "Specifies the program Ids of the equivalent automation add-ins",
          "minItems": 1,
          "maxItems": 5,
          "items": {
            "type": "string",
            "minLength": 1,
            "maxLength": 64
          }
        }
      },
      "additionalProperties": false,
      "required": [
        "progIds"
      ]
    },
    "xllCustomFunctions": {
      "type": "object",
      "description": "Specifies the XLL-based add-ins custom function",
      "properties": {
        "fileNames": {
          "type": "array",
          "description": "Specifies the file names of the XLL-based add-ins custom function",
          "minItems": 1,
          "maxItems": 5,
          "items": {
            "type": "string",
            "minLength": 1,
            "maxLength": 64
          }
        }
      },
      "additionalProperties": false,
      "required": [
        "fileNames"
      ]
    }
  },
  "additionalProperties": false,
  "anyOf": [
    {
      "required": [
        "effect",
        "comAddin"
      ]
    },
    {
      "required": [
        "effect",
        "automationAddin"
      ]
    },
    {
      "required": [
        "effect",
        "xllCustomFunctions"
      ]
    }
  ]
}

Syntax
Schema

{
  "effect": "userOptionToDisable | disableWithNotification",
  "comAddin": {
    "progIds": [
      "{string}"
    ]
  },
  "automationAddin": {
    "progIds": [
      "{string}"
    ]
  },
  "xllCustomFunctions": {
    "fileNames": [
      "{string}"
    ]
  }
}

{
  "type": "object",
  "description": "Configures how to hide windows native extensions",
  "properties": {
    "effect": {
      "type": "string",
      "description": "Specifies the effect to take while installing the web add-in if the equivalent add-in is installed.",
      "enum": [
        "userOptionToDisable",
        "disableWithNotification"
      ]
    },
    "comAddin": {
      "type": "object",
      "description": "Specifies the equivalent COM add-ins",
      "properties": {
        "progIds": {
          "type": "array",
          "description": "Specifies the program Ids of the equivalent COM add-ins",
          "minItems": 1,
          "maxItems": 5,
          "items": {
            "type": "string",
            "minLength": 1,
            "maxLength": 64
          }
        }
      },
      "additionalProperties": false,
      "required": [
        "progIds"
      ]
    },
    "automationAddin": {
      "type": "object",
      "description": "Specifies the equivalent automation add-ins",
      "properties": {
        "progIds": {
          "type": "array",
          "description": "Specifies the program Ids of the equivalent automation add-ins",
          "minItems": 1,
          "maxItems": 5,
          "items": {
            "type": "string",
            "minLength": 1,
            "maxLength": 64
          }
        }
      },
      "additionalProperties": false,
      "required": [
        "progIds"
      ]
    },
    "xllCustomFunctions": {
      "type": "object",
      "description": "Specifies the XLL-based add-ins custom function",
      "properties": {
        "fileNames": {
          "type": "array",
          "description": "Specifies the file names of the XLL-based add-ins custom function",
          "minItems": 1,
          "maxItems": 5,
          "items": {
            "type": "string",
            "minLength": 1,
            "maxLength": 64
          }
        }
      },
      "additionalProperties": false,
      "required": [
        "fileNames"
      ]
    }
  },
  "additionalProperties": false,
  "anyOf": [
    {
      "required": [
        "effect",
        "comAddin"
      ]
    },
    {
      "required": [
        "effect",
        "automationAddin"
      ]
    },
    {
      "required": [
        "effect",
        "xllCustomFunctions"
      ]
    }
  ]
}

Properties

effect

Specifies the effect to take while installing the web add-in if the equivalent add-in is installed.

Type
string

Required
—

Constraints

Supported values
Allowed values: userOptionToDisable, disableWithNotification.

comAddin

Specifies the equivalent COM or VSTO add-ins

Type
comAddin

Required
—

Constraints

Supported values

automationAddin

Specifies the equivalent automation add-ins

Type
automationAddin

Required
—

Constraints

Supported values

xllCustomFunctions

Specifies the XLL-based add-ins custom function

Type
xllCustomFunctions

Required
—

Constraints

Supported values

反馈

此页面是否有帮助？

通过

extensionAlternateVersionsArray.hide.windowsExtensions object

Syntax

Properties

effect

comAddin

automationAddin

xllCustomFunctions

反馈

其他资源