mirror of
https://github.com/StackExchange/dnscontrol.git
synced 2024-05-11 05:55:12 +00:00
71 lines
2.0 KiB
Markdown
71 lines
2.0 KiB
Markdown
---
|
|
name: M365_BUILDER
|
|
parameters:
|
|
- label
|
|
- mx
|
|
- autodiscover
|
|
- dkim
|
|
- skypeForBusiness
|
|
- mdm
|
|
- domainGUID
|
|
- initialDomain
|
|
parameters_object: true
|
|
parameter_types:
|
|
label: string?
|
|
mx: boolean?
|
|
autodiscover: boolean?
|
|
dkim: boolean?
|
|
skypeForBusiness: boolean?
|
|
mdm: boolean?
|
|
domainGUID: string?
|
|
initialDomain: string?
|
|
---
|
|
|
|
DNSControl offers a `M365_BUILDER` which can be used to simply set up Microsoft 365 for a domain in an opinionated way.
|
|
|
|
It defaults to a setup without support for legacy Skype for Business applications.
|
|
It doesn't set up SPF or DMARC. See [`SPF_BUILDER`](/language-reference/record-modifiers/dmarc_builder) and [`DMARC_BUILDER`](/language-reference/record-modifiers/spf_builder).
|
|
|
|
## Example
|
|
|
|
### Simple example
|
|
|
|
{% code title="dnsconfig.js" %}
|
|
```javascript
|
|
M365_BUILDER({
|
|
initialDomain: "example.onmicrosoft.com",
|
|
});
|
|
```
|
|
{% endcode %}
|
|
|
|
This sets up `MX` records, Autodiscover, and DKIM.
|
|
|
|
### Advanced example
|
|
|
|
{% code title="dnsconfig.js" %}
|
|
```javascript
|
|
M365_BUILDER({
|
|
label: "test",
|
|
mx: false,
|
|
autodiscover: false,
|
|
dkim: false,
|
|
mdm: true,
|
|
domainGUID: "test-example-com", // Can be automatically derived in this case, if example.com is the context.
|
|
initialDomain: "example.onmicrosoft.com",
|
|
});
|
|
```
|
|
{% endcode %}
|
|
|
|
This sets up Mobile Device Management only.
|
|
|
|
### Parameters
|
|
|
|
* `label` The label of the Microsoft 365 domain, useful if it is a subdomain (default: `"@"`)
|
|
* `mx` Set an `MX` record? (default: `true`)
|
|
* `autodiscover` Set Autodiscover `CNAME` record? (default: `true`)
|
|
* `dkim` Set DKIM `CNAME` records? (default: `true`)
|
|
* `skypeForBusiness` Set Skype for Business/Microsoft Teams records? (default: `false`)
|
|
* `mdm` Set Mobile Device Management records? (default: `false`)
|
|
* `domainGUID` The GUID of _this_ Microsoft 365 domain (default: `<label>.<context>` with `.` replaced by `-`, no default if domain contains dashes)
|
|
* `initialDomain` The initial domain of your Microsoft 365 tenant/account, ends in `onmicrosoft.com`
|