New-SCUserRole
VMM 사용자 그룹에 대한 사용자 역할을 만듭니다.
구문
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
매개 변수
-Description
사용자 역할에 대한 설명을 지정합니다.
형식: | String |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-ID
새 사용자 역할에 대한 고유 ID를 지정합니다.
형식: | Guid |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-JobGroup
동일한 작업 그룹 식별자를 포함하는 최종 명령이 실행되기 직전에 집합으로 실행되는 일련의 명령에 대한 식별자를 지정합니다.
형식: | Guid |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-JobVariable
작업 진행률을 추적하고 저장하는 변수를 지정합니다.
형식: | String |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-Name
새 사용자 역할의 이름을 지정합니다.
형식: | String |
Position: | 0 |
Default value: | None |
필수: | True |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-OnBehalfOfUser
사용자 이름을 지정합니다. 이 cmdlet은 이 매개 변수가 지정하는 사용자를 대신하여 작동합니다.
형식: | String |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-OnBehalfOfUserRole
사용자 역할을 지정합니다. 사용자 역할을 가져오려면 Get-SCUserRole cmdlet을 사용합니다. 이 cmdlet은 이 매개 변수가 지정하는 사용자 역할을 대신하여 작동합니다.
형식: | UserRole |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-ParentUserRole
기존 VMM 사용자 역할을 새 사용자 역할의 부모로 지정합니다.
형식: | UserRole |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-PROTipID
이 작업을 트리거한 PRO 팁(성능 및 리소스 최적화 팁)의 ID를 지정합니다. 이 매개 변수를 사용하면 PRO 팁을 감사할 수 있습니다.
형식: | Guid |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-RunAsynchronously
컨트롤이 명령 셸로 즉시 반환되도록 작업이 비동기적으로 실행됨을 나타냅니다.
형식: | SwitchParameter |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-UserRoleProfile
새 사용자 역할의 기초가 되는 프로필 유형을 지정합니다. 이 매개 변수에 허용되는 값은 다음과 같습니다.
- DelegatedAdmin
- ReadOnlyAdmin
- SelfServiceUser
- TenantAdmin
- VMAdmin
형식: | Profile |
허용되는 값: | Administrator, DelegatedAdmin, VMAdmin, TenantAdmin, SelfServiceUser, ReadOnlyAdmin |
Position: | Named |
Default value: | None |
필수: | True |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-VMMServer
이 cmdlet이 사용자 역할을 만드는 VMM 서버를 지정합니다.
형식: | ServerConnection |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | True |
와일드카드 문자 허용: | False |
출력
UserRole
이 cmdlet은 UserRole 개체를 반환합니다.