Domänen-Ressourcentypdomain resource type

Stellt eine Domäne dar, die dem Mandanten zugeordnet ist.Represents a domain associated with the tenant.

Verwenden Sie Domänenvorgänge, um einem Mandanten Domänen zuzuordnen, den Domänenbesitz zu überprüfen und die unterstützten Dienste zu konfigurieren.Use domain operations to associate domains to a tenant, verify domain ownership, and configure supported services. Domänenvorgänge ermöglichen Registrierungsstellen das Automatisieren der Domänenzuordnung für Dienste wie Office 365.Domain operations enable registrars to automate domain association for services such as Office 365. Beispielsweise kann eine Registrierungsstelle als Teil der Domänenregistrierung eine Vanity-Domäne für e-Mail, Websites, Authentifizierung usw. aktivieren.For example, as part of domain sign up, a registrar can enable a vanity domain for email, websites, authentication, etc.

So ordnen Sie eine Domäne einem Mandanten zu:To associate a domain with a tenant:

  1. Zuordnen einer Domäne zu einem Mandanten.Associate a domain with a tenant.

  2. Dient zum Abrufen der Domänen Überprüfungseinträge.Retrieve the domain verification records. Fügen Sie die Details des Überprüfungsdaten Satzes der Zonendatei der Domäne mithilfe der Domänenregistrierungsstelle oder der DNS-Serverkonfiguration hinzu.Add the verification record details to the domain's zone file using the domain registrar or DNS server configuration.

  3. Überprüfen Sie den Besitz der Domäne.Verify the ownership of the domain. Dadurch wird die Domäne überprüft, und die isverify -Eigenschaft wird auf truefestgelegt.This will verify the domain and set the isVerified property to true.

  4. Geben Sie die unterstützten Dienste an, die Sie mit der Domäne verwenden möchten.Indicate the supported services you plan to use with the domain.

  5. Konfigurieren Sie unterstützte Dienste durch Abrufen einer Liste von Datensätzen, die für die Aktivierung von Diensten für die Domäne benötigt werden.Configure supported services by retrieving a list of records needed to enable services for the domain. Fügen Sie die Details des Konfigurationsdaten Satzes zur Zonendatei der Domäne mithilfe der Domänenregistrierungsstelle oder der DNS-Serverkonfiguration hinzu.Add the configuration record details to the domain's zone file using the domain registrar or DNS server configuration.

MethodenMethods

MethodeMethod RückgabetypReturn Type BeschreibungDescription
Domäne abrufenGet domain domaindomain Lesen von Eigenschaften und Beziehungen eines Domänenobjekts.Read properties and relationships of a domain object.
Domäne erstellenCreate domain domaindomain Fügt eine Domäne zum Mandanten hinzu.Adds a domain to the tenant.
DomainNameReference auflistenList domainNameReference directoryObject-SammlungdirectoryObject collection Dient zum Abrufen einer Liste von Verzeichnisobjekten mit einem Verweis auf die Domäne.Retrieve a list of directory objects with a reference to the domain.
ServiceConfigurationRecords auflistenList serviceConfigurationRecords domainDnsRecord -SammlungdomainDnsRecord collection Dient zum Abrufen einer Liste von Domänen-DNS-Einträgen für die Domänenkonfiguration.Retrieve a list of domain DNS records for domain configuration.
VerificationDnsRecords auflistenList verificationDnsRecords domainDnsRecord -SammlungdomainDnsRecord collection Dient zum Abrufen einer Liste von Domänen-DNS-Einträgen für die Domänenüberprüfung.Retrieve a list of domain DNS records for domain verification.
Domäne aktualisierenUpdate domain domaindomain Aktualisiert eine Domäne.Updates a domain.
Domäne löschenDelete domain KeineNone Löscht eine Domäne.Deletes a domain.
ForceDelete-DomäneForceDelete domain KeineNone Löscht eine Domäne mithilfe eines asynchronen Vorgangs.Deletes a domain using an asynchronous operation.
Überprüfen der DomäneVerify domain domaindomain Überprüft den Besitz der Domäne.Validates the ownership of the domain.

EigenschaftenProperties

EigenschaftProperty TypType BeschreibungDescription
AuthenticationTypeauthenticationType StringString Gibt den konfigurierten Authentifizierungstyp für die Domäne an.Indicates the configured authentication type for the domain. Der Wert ist entweder verwaltet oder Verbund.The value is either Managed or Federated.
Verwaltet gibt eine verwaltete cloudbasierten Domäne an, in der Azure Ad die Benutzerauthentifizierung ausführt.Managed indicates a cloud managed domain where Azure AD performs user authentication.
Federated gibt an, dass die Authentifizierung mit einem Identitätsanbieter wie dem lokalen Active Directory des Mandanten über Active Directory Verbunddienste verbunden ist.Federated indicates authentication is federated with an identity provider such as the tenant's on-premises Active Directory via Active Directory Federation Services. Diese Eigenschaft ist schreibgeschützt und darf keine Nullwerte zulassen.This property is read-only and is not nullable.
availabilityStatusavailabilityStatus StringString Diese Eigenschaft ist immer NULL, außer wenn die Verify -Aktion verwendet wird.This property is always null except when the verify action is used. Wenn die Verify -Aktion verwendet wird, wird in der Antwort eine Domänen Entität zurückgegeben.When the verify action is used, a domain entity is returned in the response. Die availabilityStatus -Eigenschaft der Domänen Entität in der Antwort ist entweder Verfügbarkeit unmittelbar oder EmailVerifiedDomainTakeoverScheduled.The availabilityStatus property of the domain entity in the response is either AvailableImmediately or EmailVerifiedDomainTakeoverScheduled.
idid StringString Der vollqualifizierte Name der Domäne.The fully qualified name of the domain. Key, unveränderlich, nicht Nullable, eindeutigKey, immutable, not nullable, unique
isAdminManagedisAdminManaged BooleschBoolean Der Wert der Eigenschaft ist false, wenn die DNS-Datensatzverwaltung der Domäne an Office 365 delegiert wurde.The value of the property is false if the DNS record management of the domain has been delegated to Office 365. Andernfalls ist der Wert true.Otherwise, the value is true. Nicht NullableNot nullable
isDefaultisDefault Boolescher WertBoolean True, wenn dies die Standarddomäne ist, die für die Benutzererstellung verwendet wird.True if this is the default domain that is used for user creation. Es gibt nur eine Standarddomäne pro Unternehmen.There is only one default domain per company. Nicht NullableNot nullable
isinitialisInitial BooleanBoolean True, wenn dies die anfängliche Domäne ist, die von Microsoft Online Services (CompanyName.onmicrosoft.com) erstellt wurde.True if this is the initial domain created by Microsoft Online Services (companyname.onmicrosoft.com). Es gibt nur eine anfängliche Domäne pro Unternehmen.There is only one initial domain per company. Nicht NullableNot nullable
IsRootisRoot BooleschBoolean True, wenn die Domäne eine überprüfte Stammdomäne ist.True if the domain is a verified root domain. Andernfalls false, wenn die Domäne eine Unterdomäne ist oder nicht überprüft wird.Otherwise, false if the domain is a subdomain or unverified. Nicht NullableNot nullable
isverifiziertisVerified BooleschBoolean True, wenn die Domänenbesitz Überprüfung abgeschlossen wurde.True if the domain has completed domain ownership verification. Nicht NullableNot nullable
passwordNotificationWindowInDayspasswordNotificationWindowInDays Int32Int32 Gibt die Anzahl von Tagen an, bis ein Benutzer benachrichtigt wird, dass das Kennwort abläuft.Specifies the number of days before a user receives notification that their password will expire. Wenn die Eigenschaft nicht festgelegt ist, wird ein Standardwert von 14 Tagen verwendet.If the property is not set, a default value of 14 days will be used.
passwordValidityPeriodInDayspasswordValidityPeriodInDays Int32Int32 Gibt an, wie lange ein Kennwort gültig ist, bevor es geändert werden muss.Specifies the length of time that a password is valid before it must be changed. Wenn die Eigenschaft nicht festgelegt ist, wird ein Standardwert von 90 Tagen verwendet.If the property is not set, a default value of 90 days will be used.
supportedServicessupportedServices String collectionString collection Die der Domäne zugewiesenen Funktionen.The capabilities assigned to the domain.

Kann 0, 1 oder mehrere der folgenden Werte enthalten: e-Mail, SharePoint, EmailInternalRelayOnly, OfficeCommunicationsOnline, SharePointDefaultDomain, FullRedelegation, SharePointPublic, OrgIdAuthentication, jammern, InTuneCan include 0, 1 or more of following values: Email, Sharepoint, EmailInternalRelayOnly, OfficeCommunicationsOnline, SharePointDefaultDomain, FullRedelegation, SharePointPublic, OrgIdAuthentication, Yammer, Intune

Die Werte, die Sie mithilfe der Graph-API hinzufügen/entfernen können, sind: e-Mail, OfficeCommunicationsOnline, jammernThe values which you can add/remove using Graph API include: Email, OfficeCommunicationsOnline, Yammer
Nicht NullableNot nullable
Zustandstate domainStatedomainState Status von asynchronen Vorgängen, die für die Domäne geplant sind.Status of asynchronous operations scheduled for the domain.

BeziehungenRelationships

Beziehungen zwischen einer Domäne und anderen Objekten im Verzeichnis, beispielsweise deren Überprüfungsdaten Sätzen und Dienst Konfigurationseinträgen, werden über Navigationseigenschaften verfügbar gemacht.Relationships between a domain and other objects in the directory such as its verification records and service configuration records are exposed through navigation properties. Sie können diese Beziehungen lesen, indem Sie diese Navigationseigenschaften in Ihren Anforderungen abzielen.You can read these relationships by targeting these navigation properties in your requests.

BeziehungRelationship TypType BeschreibungDescription
domainNameReferencesdomainNameReferences directoryObject-SammlungdirectoryObject collection Schreibgeschützt, NullableRead-only, Nullable
serviceConfigurationRecordsserviceConfigurationRecords domainDnsRecord -SammlungdomainDnsRecord collection DNS-Einträge, die der Kunde der DNS-Zonendatei der Domäne hinzufügt, bevor die Domäne von Microsoft Online Services verwendet werden kann.DNS records the customer adds to the DNS zone file of the domain before the domain can be used by Microsoft Online services.
Schreibgeschützt, NullableRead-only, Nullable
verificationDnsRecordsverificationDnsRecords domainDnsRecord -SammlungdomainDnsRecord collection DNS-Einträge, die der Kunde der DNS-Zonendatei der Domäne hinzufügt, bevor der Kunde die Überprüfung des Domänenbesitzes mit Azure AD abschließen kann.DNS records that the customer adds to the DNS zone file of the domain before the customer can complete domain ownership verification with Azure AD.
Schreibgeschützt, NullableRead-only, Nullable

JSON-DarstellungJSON representation

Es folgt eine JSON-Darstellung der Ressource.Here is a JSON representation of the resource.

{
  "authenticationType": "String",
  "availabilityStatus": "String",
  "id": "String (identifier)",
  "isAdminManaged": true,
  "isDefault": true,
  "isInitial": true,
  "isRoot": true,
  "isVerified": true,
  "passwordNotificationWindowInDays": 14,
  "passwordValidityPeriodInDays": 90,
  "state": {"@odata.type": "microsoft.graph.domainState"},
  "supportedServices": ["String"]
}