Get-ManagementRoleEntry
cmdlet은 온-프레미스 Exchange 및 클라우드 기반 서비스에서 제공됩니다. 일부 매개 변수와 설정은 특정 환경에서만 사용할 수 있습니다.
Get-ManagementRoleEntry cmdlet을 사용하면 관리 역할에 구성되어 있는 관리 역할 항목을 검색할 수 있습니다.
아래 구문 섹션에 있는 매개 변수 집합에 대한 자세한 내용은 Exchange cmdlet 구문을 참조하십시오.
Syntax
Get-ManagementRoleEntry
[-Identity] <RoleEntryIdParameter>
[-DomainController <Fqdn>]
[-Parameters <String[]>]
[-PSSnapinName <String>]
[-Type <ManagementRoleEntryType[]>]
[<CommonParameters>]
Description
Get-ManagementRoleEntry cmdlet은 역할에 구성되어 있는 역할 항목을 검색합니다. 역할 이름, cmdlet 이름, 매개 변수 이름 또는 각 항목의 조합 또는 역할 항목 유형 또는 연결된 Windows PowerShell 스냅인과 같은 특정 조건과 일치하는 특정 역할 항목을 검색할 수 있습니다.
관리 역할 항목에 대한 자세한 내용은 관리 역할 이해를 참조하세요.
이 cmdlet을 실행하려면 먼저 사용 권한을 할당받아야 합니다. 이 항목에는 해당 cmdlet의 모든 매개 변수가 나열되지만 사용자에게 할당된 사용 권한에 포함되지 않은 일부 매개 변수에는 액세스할 수 없습니다. 조직에서 cmdlet 또는 매개 변수를 실행하는 데 필요한 사용 권한을 확인하려면 Find the permissions required to run any Exchange cmdlet를 참조하세요.
예제
예 1
Get-ManagementRoleEntry "Transport Rules\*"
이 예에서는 Transport Rules 관리 역할에 있는 모든 역할 항목의 목록을 검색합니다.
예 2
Get-ManagementRoleEntry *\Get-Recipient
이 예에서는 Get-Recipient cmdlet이 포함된 모든 역할 항목의 목록을 검색합니다.
예 3
Get-ManagementRoleEntry "Tier 2 Help Desk\Set-Mailbox" | Format-List Name, Parameters, Role, Type
이 예에서는 Tier 2 Help Desk\Set-Mailbox 역할 항목을 검색하고 Get-ManagementRoleEntry cmdlet의 결과를 Format-List 명령에 파이프합니다. Format-List cmdlet은 역할 항목에서 이름, 매개 변수, 역할 및 형식 속성만 출력합니다.
매개 변수
-DomainController
이 매개 변수는 온프레미스 Exchange에서만 사용 가능합니다.
DomainController 매개 변수는 Active Directory에서 데이터를 읽거나 쓰기 위해 이 cmdlet이 사용하는 도메인 컨트롤러를 지정합니다. FQDN(정규화된 도메인 이름)으로 도메인 컨트롤러를 식별합니다. 예: dc01.contoso.com
Type: | Fqdn |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Identity
Identity 매개 변수는 보려는 역할 항목을 지정합니다. 이 매개 변수는 구문을 사용합니다(예CustomRole\Set-Mailbox
: <management role>\<role entry name>
).
관리 역할 항목의 작동 방식에 대한 자세한 내용은 관리 역할 이해를 참조하세요.
역할, cmdlet 이름 또는 둘 다 대신 와일드카드 문자(*)를 사용할 수 있습니다.
역할 항목 이름에 공백이 있는 경우 이름을 큰따옴표(")로 묶습니다.
Type: | RoleEntryIdParameter |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-Parameters
Parameters 매개 변수는 지정된 매개 변수가 들어 있는 역할 항목만 포함합니다. 매개 변수가 여러 개인 경우 각 매개 변수를 쉼표로 구분하여 지정할 수 있습니다. 부분 매개 변수 이름과 함께 와일드카드 문자(*)를 사용하여 지정한 값과 일치하는 모든 매개 변수를 검색할 수 있습니다.
이 매개 변수는 Identity 매개 변수에 지정한 값과 함께 와일드카드 문자(*)를 사용하는 경우에 유용합니다.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-PSSnapinName
PSSnapinName 매개 변수는 반환할 역할 항목을 포함하는 Windows PowerShell 스냅인을 지정합니다. Get-PSSnapin cmdlet을 사용하여 사용 가능한 Windows PowerShell 스냅인 목록을 검색합니다.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-Type
Type 매개 변수는 반환할 역할 항목의 유형을 지정합니다. Type 매개 변수의 유효한 값은 쉼표로 구분된 다음 매개 변수의 조합입니다. Cmdlet, Script 및 ApplicationPermission.
Type: | ManagementRoleEntryType[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
입력
Input types
이 cmdlet이 수락하는 입력 형식을 보려면 Cmdlet 입출력 형식을 참조하세요. cmdlet의 입력 형식 필드가 비어 있을 경우 cmdlet은 입력 데이터를 수락하지 않습니다.
출력
Output types
이 cmdlet이 수락하는 반환 형식(출력 형식이라고도 함)을 보려면 Cmdlet 입출력 형식을 참조하세요. 출력 형식 필드가 비어 있는 경우 cmdlet은 데이터를 반환하지 않습니다.