Get-MsolDomain
Updated: July 30, 2015
Applies To: Azure, Office 365, Windows Intune
Note
- The cmdlets were previously known as the Microsoft Online Services Module for Windows PowerShell cmdlets.
The Get-MsolDomain cmdlet is used to retrieve company domains.
Syntax
Get-MsolDomain [-Authentication <DomainAuthenticationType>] [-Capability <string>] [-Status <string>] [-TenantId <Guid>] [<CommonParameters>]
Get-MsolDomain -DomainName <string> [-TenantId <Guid>] [<CommonParameters>]
Parameters
-Authentication <DomainAuthenticationType>
The filter for the specified authentication type. If provided, only
domains with the authentication type will be returned.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-Capability <string>
The filter for domains that have the specified capability assigned.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-DomainName <string>
The fully qualified domain name to retrieve.
Required? true
Position? named
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-Status <string>
The filter to return only domains with the specified status. Valid
values are Verified, Unverified, and PendingDeletion.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-TenantId <Guid>
The unique ID of the tenant to perform the operation on. If this is
not provided then the value will default to the tenant of the current
user. This parameter is only applicable to partner users.
Required? false
Position? named
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer and OutVariable. For more information, type,
"get-help about_commonparameters".
Examples
Output is provided by Microsoft.Online.Administration.Domain. The cmdlet returns the following information:
Authentication: The authentication type of the domain (managed or federated).
Capabilities: The capabilities assigned to the domain. These can be SharePoint, email, or Communicator. A domain with SharePoint capability cannot be used for other capabilities.
IsDefault: This is the default domain that is used for user creation. There is only one default domain per company.
IsInitial: Whether or not this is the initial domain created by (companyname.onmicrosoft.com).
Name: The full name of the domain.
RootDomain: For subdomains, this represents the root domain. Only root domains need to be verified, and all subdomains will be automatically verified.
Status: The status of the domain (verified or unverified).
Example 1
The following command retrieves all domains for the company (verified or unverified).
Get-Domain
Output is provided by Microsoft.Online.Administration.Domain. Each domain returned will include the following information:
Authentication: The authentication type of the domain (managed or federated).
Capabilities: The capabilities assigned to the domain. These can be SharePoint, email, or Communicator. A domain with SharePoint capability cannot be used for other capabilities.
IsDefault: This is the default domain that is used for user creation. There is only one default domain per company.
IsInitial: Whether or not this is the initial domain created by Office 365 (companyname.onmicrosoft.com).
Name: The full name of the domain.
RootDomain: For subdomains, this represents the root domain. Only root domains need to be verified, and all subdomains will be automatically verified.
Status: The status of the domain (verified or unverified).
Example 2
The following command retrieves the contoso.com domain.
Get-Domain -Name contoso.com
Example 3
The following command returns a list of verified company domains.
Get-Domain -Status Verified
Additional Resources
There are several other places you can get more information and help. These include: