Remove-RdsAppGroupUser
Entfernt den Zugriff eines Benutzers auf eine App-Gruppe.
Syntax
Default (Standardwert)
Remove-RdsAppGroupUser
[-TenantName] <String>
[-HostPoolName] <String>
[-AppGroupName] <String>
[-UserPrincipalName] <String>
[<CommonParameters>]
Beschreibung
Mit dem Cmdlet Remove-RdsAppGroupUser wird der Zugriff eines Benutzers auf die angegebene App-Gruppe entfernt. Dieses Cmdlet akzeptiert jeweils nur einen einzelnen Benutzerprinzipalnamen (User Principal Name, UPN) und gilt nur für Benutzer (nicht für Gruppen). Um mehrere Benutzer gleichzeitig zu entfernen, können Sie die PowerShell-Schleifensyntax verwenden. Dieses Cmdlet unterstützt keine Gruppen als UPNs.
Der UPN muss in dem Azure Active Directory vorhanden sein, das dem Mandanten zugeordnet ist. Wenn dem Benutzer noch kein Zugriff auf die App-Gruppe zugewiesen wurde, ist das Cmdlet im Hintergrund erfolgreich.
Beispiele
Beispiel 1
PS C:\> Remove-RdsAppGroupUser -TenantName "contoso" -HostPoolName "contosoHostPool" -AppGroupName "officeApps" -UserPrincipalName "user1@contoso.com"
Mit diesem Befehl wird dem Benutzer der Zugriff auf die App-Gruppe entzogen.
Parameter
-AppGroupName
Der Name der App-Gruppe.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | 2 |
| Obligatorisch.: | True |
| Wert aus Pipeline: | True |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
-HostPoolName
Der Name des Hostpools.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | 1 |
| Obligatorisch.: | True |
| Wert aus Pipeline: | True |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
-TenantName
Der Name des Mandanten.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | 0 |
| Obligatorisch.: | True |
| Wert aus Pipeline: | True |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
-UserPrincipalName
Der Benutzerprinzipalname (User Principal Name, UPN) des Benutzers, dessen App-Gruppenzugriff Sie entfernen möchten.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | 3 |
| Obligatorisch.: | True |
| Wert aus Pipeline: | True |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
CommonParameters
Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.