Remove-SCUserRole

Modul:

VirtualMachineManager

Odebere existující roli uživatele.

Syntaxe

Remove-SCUserRole
      [-UserRole] <UserRole>
      [-JobGroup <Guid>]
      [-RunAsynchronously]
      [-PROTipID <Guid>]
      [-JobVariable <String>]
      [-WhatIf]
      [-Confirm]
      [-OnBehalfOfUser <String>]
      [-OnBehalfOfUserRole <UserRole>]
      [<CommonParameters>]

Description

Rutina Remove-SCUserRole odebere existující roli uživatele z nástroje Virtual Machine Manager (VMM). Můžete odebrat následující role: Delegovaný správce, Read-Only Správce nebo Self-Service Uživatel. Roli Správce nelze odebrat.

Příklady

Příklad 1: Odebrání zadané role uživatele

PS C:\> $UserRole = Get-SCUserRole -Name "ContosoDelegatedAdmin"
PS C:\> Remove-SCUserRole -UserRole $UserRole

První příkaz získá objekt role uživatele s názvem ContosoDelegatedAdmin a pak tento objekt uloží do proměnné $UserRole.

Druhý příkaz odebere roli uživatele uloženou v $UserRole z databáze VMM.

Parametry

-Confirm

Před spuštěním rutiny vás vyzve k potvrzení.

Typ:	SwitchParameter
Aliasy:	cf
Position:	Named
Default value:	False
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-JobGroup

Určuje identifikátor pro řadu příkazů, které se spouští jako sada těsně před posledním příkazem, který obsahuje stejné spuštění identifikátoru skupiny úloh.

Typ:	Guid
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-JobVariable

Určuje proměnnou, ve které je průběh úlohy sledován a uložen.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-OnBehalfOfUser

Určuje uživatelské jméno. Tato rutina funguje jménem uživatele, který tento parametr určuje.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-OnBehalfOfUserRole

Určuje roli uživatele. Pokud chcete získat roli uživatele, použijte rutinu Get-SCUserRole. Tato rutina funguje jménem role uživatele, kterou tento parametr určuje.

Typ:	UserRole
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-PROTipID

Určuje ID tipu pro optimalizaci výkonu a prostředků (TIP PRO), který tuto akci aktivoval. Tento parametr umožňuje auditovat tipy PRO.

Typ:	Guid
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-RunAsynchronously

Označuje, že úloha běží asynchronně, aby se ovládací prvek okamžitě vrátil do příkazového prostředí.

Typ:	SwitchParameter
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-UserRole

Určuje objekt role uživatele, který tato rutina odebere. Pokud chcete získat roli uživatele, použijte rutinu Get-SCUserRole.

Typ:	UserRole
Position:	0
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-WhatIf

Ukazuje, co se stane, když se rutina spustí. Rutina se nespustí.

Typ:	SwitchParameter
Aliasy:	wi
Position:	Named
Default value:	False
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

Související odkazy

• Get-SCUserRole
• New-SCUserRole
• Set-SCUserRole