SALES: 1-800-867-1380
Connect-AadrmService

Connect-AadrmService

Updated: July 1, 2015

Connect-AadrmService

Connects to Rights Management.

Syntax

Parameter Set: Default
Connect-AadrmService -Credential <PSCredential> [-TenantId <Guid> ] [ <CommonParameters>]




Detailed Description

The Connect-AadrmService cmdlet connects you to the Azure Rights Management service. This cmdlet can also be used by a partner company that manages your tenant.

Connect by using this cmdlet before you configure Rights Management by using other cmdlets in this module.

When you are prompted for credentials, use an account that is one of the following:

-- A global admin for your Office 365 tenant.

-- A global administrator for your Azure tenant. However, this account cannot be a Microsoft account (MSA) or from another Azure tenant.

-- A user account that has been granted administrative rights to Azure RMS by using the Add-AadrmRoleBasedAdministrator cmdlet.

Parameters

-Credential<PSCredential>

Specifies a PSCredential object. To obtain a PSCredential object, use the Get-Credential cmdlet. For more information, type Get-Help Get-Cmdlet. Alternatively, provide a user name. The cmdlet prompts you for a password.


Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-TenantId<Guid>

Specifies the tenant GUID. The cmdlet connects to Rights Management for the tenant that you specify by GUID. If you do not specify this parameter, the cmdlet connects to the tenant the user belongs to.

Tip: If you are not prompted for your credentials, and you see an error message such as Cannot use this feature without credentials, verify that Internet Explorer is configured to use Windows integrated authentication. If this setting is not enable, enable it, restart Internet Explorer, and then retry authentication to the Rights Management service.


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

<CommonParameters>

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see    about_CommonParameters.

Inputs

The input type is the type of the objects that you can pipe to the cmdlet.

Outputs

The output type is the type of the objects that the cmdlet emits.

Examples

Example 1: Connect to Rights Management

The first command creates a PSCredential object, and then stores it in the $AdminCredentials variable. The command prompts you for a password:

The second command connects to the Rights Management service by using the credentials stored in $AdminCredentials.


PS C:\> $AdminCredentials = Get-Credential "Admin@aadrm.contoso.com"
PS C:\> 
Connect-AadrmService -Credential $AdminCredentials

Related topics

Show:
© 2016 Microsoft