Udostępnij przez


Remove-DataGatewayClusterUser

Usuwa użytkowników (w tym administratorów) z klastra bramy

Składnia

Default (Domyślna)

Remove-DataGatewayClusterUser
    [-Scope <PowerBIUserScope>]
    [-RegionKey <String>]
    -GatewayClusterId <Guid>
    -PrincipalObjectId <Guid>
    [<CommonParameters>]

Opis

Usuwa użytkowników (w tym administratorów) z klastra bramy

Przykłady

Przykład 1

PS C:\> $userToRemove = $(Get-AzADUser -ObjectId "testUpn@tenant.com").Id
PS C:\> Remove-DataGatewayClusterUser -GatewayClusterId DC8F2C49-5731-4B27-966B-3DB5094C2E77 -PrincipalObjectId $userToRemove

Usuwa użytkownika "testUpn@tenant.com" z klastra bramy.

Przykład 2

PS C:\> $userToRemove = $(Get-AzADUser -ObjectId "testUpn@tenant.com").Id
PS C:\> Remove-DataGatewayClusterUser -GatewayClusterId DC8F2C49-5731-4B27-966B-3DB5094C2E77 -PrincipalObjectId $userToRemove -RegionKey brazilsouth

Usuwa użytkownika "testUpn@tenant.com" z klastra bramy. To polecenie jest uruchamiane w regionie Południowo-Brazylii, więc podany identyfikator klastra bramy powinien znajdować się w tym regionie.

Parametry

-GatewayClusterId

Klaster bramy, w którym użytkownik musi zostać usunięty

Właściwości parametru

Typ:Guid
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False
Aliasy:Klaster, Id

Zestawy parametrów

(All)
Position:Named
Obowiązkowy:True
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-PrincipalObjectId

Identyfikator obiektu głównego usługi Azure Active Directory (AAD) (tj. identyfikator użytkownika) użytkownika do usunięcia

Właściwości parametru

Typ:Guid
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False
Aliasy:Użytkownik

Zestawy parametrów

(All)
Position:Named
Obowiązkowy:True
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-RegionKey

Region, w którym to polecenie musi działać. Brak podania -RegionKey spowoduje uruchomienie polecenia w regionie domyślnym dla dzierżawy. Aby uzyskać listę dostępnych parametrów regionu, uruchom polecenie Get-DataGatewayRegion

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-Scope

Zakres zabezpieczeń do uruchomienia polecenia. Pozwoliłoby to określić, czy używasz tego polecenia w zakresie administratora dzierżawy/usługi lub administratora bramy

Właściwości parametru

Typ:PowerBIUserScope
Domyślna wartość:Individual
Dopuszczalne wartości:Individual, Organization
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

CommonParameters

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.

Dane wejściowe

None

Dane wyjściowe

System.Void