Set-DataGatewayInstaller
Modify list of users who can install and register new gateways in your organization You need to login as a Tenant Admin to run this command.
Syntax
Default (Default)
Set-DataGatewayInstaller
[-PrincipalObjectIds <String[]>]
-Operation <OperationType>
-GatewayType <GatewayType>
[<CommonParameters>]
Description
Set which users can install and register new gateways in your organization.
Examples
Example 1
PS C:\> $user1 = $(Get-AzADUser -ObjectId "testUpn@tenant.com").Id
PS C:\> $user2 = $(Get-AzADUser -ObjectId "testUpn@tenant.com").Id
PS C:\> Set-DataGatewayInstaller -PrincipalObjectIds $user1,$user2 -Operation Add -GatewayType Resource
Allow users testUpn1@tenant.com, and testUpn2@tenant.com to register and install an On-premises data gateway in a standard mode.
Example 2
PS C:\> $user1 = $(Get-AzADUser -ObjectId "testUpn@tenant.com").Id
PS C:\> $user2 = $(Get-AzADUser -ObjectId "testUpn@tenant.com").Id
PS C:\> Set-DataGatewayInstaller -PrincipalObjectIds $user1,$user2 -Operation Remove -GatewayType Resource
Users testUpn1@tenant.com, and testUpn2@tenant.com are no longer allowed to register and install an On-premises data gateway in a standard mode.
Parameters
-GatewayType
Gateway type the command takes effect on. The value Resource below would mean the On-premises data gateway running in a standard mode.
Parameter properties
| Type: | GatewayType |
| Default value: | None |
| Accepted values: | Resource, Personal, VirtualNetwork |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | True |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-Operation
The operation to perform for the specified user.
Parameter properties
| Type: | OperationType |
| Default value: | None |
| Accepted values: | None, Add, Remove |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | True |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-PrincipalObjectIds
List of Azure Active Directory (AAD) principal object IDs (i.e. user IDs) that can configure gateways in your organization.
Parameter properties
| Type: | String[] |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
| Aliases: | Users |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
CommonParameters
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.