다음을 통해 공유


Get-SCUserRole

VMM 사용자 역할을 가져옵니다.

Syntax

Get-SCUserRole
   [-VMMServer <ServerConnection>]
   [[-Name] <String>]
   [-UserRoleProfile <Profile>]
   [-ID <Guid>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

Description

Get-SCUserRole cmdlet은 하나 이상의 VMM(Virtual Machine Manager) 사용자 역할을 가져옵니다. VMM은 역할 기반 보안을 사용하여 지정된 사용자 역할의 멤버가 작동할 수 있는 경계와 사용자 역할의 허용된 작업 멤버가 수행할 수 있는 일련의 경계를 정의합니다.

사용자 역할을 만드는 방법에 대한 자세한 내용은 을 입력합니다 Get-Help New-SCUserRole.

위임된 관리자 및 읽기 전용 관리자의 범위와 셀프 서비스 사용자에 대한 범위 및 작업을 포함하여 사용자 역할의 속성을 설정하는 방법에 대한 자세한 내용을 보려면 다음을 입력합니다 Get-Help Set-SCUserRole.

예제

예제 1: 모든 사용자 역할 가져오기

PS C:\> Get-SCUserRole -VMMServer "VMMServer01.Contoso.com"

이 명령은 VMMServer01.Contoso.com 서버의 모든 VMM 사용자 역할을 가져옵니다. 이 명령은 각 사용자 역할에 대한 정보를 표시합니다.

예제 2: 이름으로 사용자 역할 가져오기

PS C:\> Get-SCUserRole -Name "Administrator"

이 명령은 Administrator라는 사용자 역할 개체를 가져옵니다. 이 명령은 해당 사용자 역할에 대한 정보를 표시합니다.

예제 3: 프로필별 사용자 역할 가져오기

PS C:\> Get-SCUserRole -VMMServer "VMMServer01.Contoso.com" -UserRoleProfile "SelfServiceUser"

이 명령은 SelfServiceUser의 사용자 역할 프로필이 있는 VMMServer01이라는 서버의 사용자 역할을 가져옵니다. 이 명령은 이러한 사용자 역할에 대한 정보를 표시합니다.

예제 4: 사용자 역할 개체에 대한 속성 및 기타 정보 표시

PS C:\> $UserRoles = Get-SCUserRole -VMMServer "VMMServer01.Contoso.com"
PS C:\> $UserRoles | Select-Object -Property Name, UserRoleProfile, ParentUserRole, Cloud
PS C:\> $UserRoles | Get-Member

첫 번째 명령은 VMMServer01이라는 서버의 모든 사용자 역할 개체를 가져오고 해당 개체를 $UserRoles 변수에 저장합니다.

두 번째 명령은 $UserRoles 각 사용자 역할 개체를 Select-Object cmdlet에 전달한 다음 각 사용자 역할에 대한 이름, 사용자 역할 프로필, 부모 사용자 역할 및 클라우드를 표시합니다.

최종 명령은 $UserRoles 각 사용자 역할을 Get-Member cmdlet에 전달합니다. 이 cmdlet은 각 사용자 역할에 대한 .NET 유형과 각 사용자 역할 유형과 연결된 메서드 및 속성을 표시합니다.

매개 변수

-ID

이 cmdlet이 가져오는 사용자 역할에 대한 고유 ID를 지정합니다.

Type:Guid
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

이 cmdlet이 가져오는 VMM 사용자 역할의 이름을 지정합니다.

Type:String
Position:0
Default value:None
Required:False
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

-UserRoleProfile

이 cmdlet이 가져오는 사용자 역할의 기초가 되는 프로필 유형을 지정합니다. 이 매개 변수에 허용되는 값은 다음과 같습니다.

  • DelegatedAdmin
  • ReadOnlyAdmin
  • SelfServiceUser
Type:Profile
Accepted values:Administrator, DelegatedAdmin, TenantAdmin, SelfServiceUser, ReadOnlyAdmin
Position:Named
Default value:None
Required:False
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 개체를 반환합니다.