New-SCUserRole
VMM 사용자 그룹에 대한 사용자 역할을 만듭니다.
Syntax
New-SCUserRole
[-VMMServer <ServerConnection>]
[-Name] <String>
-UserRoleProfile <Profile>
[-ID <Guid>]
[-JobGroup <Guid>]
[-Description <String>]
[-ParentUserRole <UserRole>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>] Description
New-SCUserRole cmdlet은 VMM(Virtual Machine Manager) 사용자 그룹에 대한 사용자 역할을 만듭니다. 위임된 관리자, Read-Only 관리자, Virtual Machine 관리자 및 Self-Service 사용자와 같은 사용자 역할을 만들 수 있습니다. 관리자 역할이 하나만 있습니다. 다른 관리자 역할을 만들거나 기존 관리자 역할을 삭제할 수 없습니다.
위임된 관리자 사용자 역할의 멤버인 경우 사용자 역할을 만들 수 있습니다. 그러나 새 사용자 역할의 범위는 부모 사용자 역할 범위의 하위 집합이어야 합니다.
사용자 역할을 만든 후 Set-SCUserRole cmdlet을 사용하여 사용자 역할의 이름을 바꾸고, 멤버를 추가하거나 제거하고, 역할의 멤버가 관리할 수 있는 개체의 범위를 추가하거나 수정할 수 있습니다. Self-Service 사용자 역할의 경우 Self-Service 사용자 역할의 멤버가 가상 머신에서 수행할 수 있는 작업을 지정할 수 있으며, 셀프 서비스 사용자가 만들 수 있는 가상 머신 수를 제한하는 할당량을 정의할 수 있습니다. 관리자 역할을 만들거나 제거하거나 범위를 제한할 수는 없지만 Set-SCUserRole 을 사용하여 해당 역할에 멤버를 추가하거나 제거할 수 있습니다.
사용자 역할의 속성을 수정하는 방법에 대한 자세한 내용은 다음을 입력합니다 Get-Help Set-SCUserRole.
예제
예제 1: 위임된 관리자 사용자 역할 만들기
PS C:\> New-SCUserRole -Name "ContosoDelegatedAdmin" -Description "Delegated Administrators for the Contoso.com domain" -UserRoleProfile "DelegatedAdmin"이 명령은 ContosoDelegatedAdmin이라는 위임된 관리자 사용자 역할을 만들고, Contoso.com 도메인에 대해 위임된 관리자에 대한 설명을 제공하고, UserRoleProfile 매개 변수를 사용하여 사용자 역할 유형을 위임된 관리자로 지정합니다.
예제 2: 셀프 서비스 사용자 역할 만들기
PS C:\> $SelfServiceRole = New-SCUserRole -Name "ContosoSelfServiceUsers" -UserRoleProfile "SelfServiceUser"이 명령은 ContosoSelfServiceUsers라는 새 사용자 역할을 만들고, UserRoleProfile 매개 변수를 사용하여 새 사용자 역할 유형을 Self-Service 사용자로 지정하고, 새 사용자 역할 개체를 $SelfServiceRole 변수에 저장합니다.
예제 3: Virtual Machine 관리자 역할 만들기
PS C:\> New-SCUserRole -Name "VirtualMachineAdmin" -UserRoleProfile "VMAdmin" -Description "Virtual Machine administrator for contoso.com domain"이 명령은 VirtualMachineAdmin이라는 Virtual Machine 관리자 사용자 역할을 만들고, 'contoso.com 도메인에 대한 Virtual Machine 관리자' 설명을 제공하고, UserRoleProfile 매개 변수를 사용하여 사용자 역할 유형을 VMAdmin으로 지정합니다.
매개 변수
-Description
사용자 역할에 대한 설명을 지정합니다.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ID
새 사용자 역할에 대한 고유 ID를 지정합니다.
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-JobGroup
동일한 작업 그룹 식별자를 포함하는 최종 명령이 실행되기 직전에 집합으로 실행되는 일련의 명령에 대한 식별자를 지정합니다.
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-JobVariable
작업 진행률을 추적하고 저장하는 변수를 지정합니다.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Name
새 사용자 역할의 이름을 지정합니다.
| Type: | String |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-OnBehalfOfUser
사용자 이름을 지정합니다. 이 cmdlet은 이 매개 변수가 지정하는 사용자를 대신하여 작동합니다.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-OnBehalfOfUserRole
사용자 역할을 지정합니다. 사용자 역할을 가져오려면 Get-SCUserRole cmdlet을 사용합니다. 이 cmdlet은 이 매개 변수가 지정하는 사용자 역할을 대신하여 작동합니다.
| Type: | UserRole |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ParentUserRole
기존 VMM 사용자 역할을 새 사용자 역할의 부모로 지정합니다.
| Type: | UserRole |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PROTipID
이 작업을 트리거한 PRO 팁(성능 및 리소스 최적화 팁)의 ID를 지정합니다. 이 매개 변수를 사용하면 PRO 팁을 감사할 수 있습니다.
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RunAsynchronously
컨트롤이 명령 셸로 즉시 반환되도록 작업이 비동기적으로 실행됨을 나타냅니다.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UserRoleProfile
새 사용자 역할의 기초가 되는 프로필 유형을 지정합니다. 이 매개 변수에 허용되는 값은 다음과 같습니다.
- DelegatedAdmin
- ReadOnlyAdmin
- SelfServiceUser
- TenantAdmin
- VMAdmin
| Type: | Profile |
| Accepted values: | Administrator, DelegatedAdmin, VMAdmin, TenantAdmin, SelfServiceUser, ReadOnlyAdmin |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VMMServer
이 cmdlet이 사용자 역할을 만드는 VMM 서버를 지정합니다.
| Type: | ServerConnection |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
출력
UserRole
이 cmdlet은 UserRole 개체를 반환합니다.