다음을 통해 공유


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"

이 명령은 virtualMachineAdminVirtual Machine 관리자 사용자 역할을 만들고, 'contoso.com 도메인에 대한 Virtual Machine 관리자'라는 설명을 제공하고, UserRoleProfile 매개 변수를 사용하여 사용자 역할 유형을 VMAdmin으로 지정합니다.

매개 변수

-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 개체를 반환합니다.