New-AzureADMSGroup

  • 참조
모듈:
AzureAD

Azure AD 그룹을 만듭니다.

Syntax

New-AzureADMSGroup
   [-Description <String>]
   -DisplayName <String>
   [-IsAssignableToRole <Boolean>]
   -MailEnabled <Boolean>
   -MailNickname <String>
   -SecurityEnabled <Boolean>
   [-GroupTypes <System.Collections.Generic.List`1[System.String]>]
   [-Visibility <String>]
   [<CommonParameters>]

Description

New-AzureADMSGroup cmdlet은 Azure Active Directory(Azure AD) 그룹을 만듭니다.

예제

예: 역할에 할당할 수 있는 그룹 만들기

PS C:\> New-AzureADMSGroup -DisplayName "HelpDesk admin group" -Description "Group assignable to role" -MailEnabled $False -MailNickname "helpDeskAdminGroup" -SecurityEnabled $True -IsAssignableToRole $True -Visibility "Private"

Id                            : 1026185e-25df-4522-a380-7ab697a7241c
Description                   : Group assignable to role
OnPremisesSyncEnabled         : 
DisplayName                   : HelpDesk admin group
Mail                          : 
MailEnabled                   : False
IsAssignableToRole            : True 
MailNickname                  : helpDeskAdminGroup
ProxyAddresses                : {} 
SecurityEnabled               : True 
GroupTypes                    : {}

매개 변수

-Description

그룹에 대한 설명을 지정합니다.

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

-DisplayName

그룹의 표시 이름을 지정합니다.

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

-GroupTypes

그룹이 통합 또는 동적 그룹임을 지정합니다.

참고:

  • 이 매개 변수는 현재 동적 그룹을 만드는 데 사용할 수 없습니다. PowerShell에서 동적 그룹을 만들려면 Azure AD 미리 보기 모듈을 사용해야 합니다.
Type:List<T>[String]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-IsAssignableToRole

그룹에 역할을 할당할 수 있는지 여부를 나타냅니다. 이 속성은 그룹을 만들 때만 설정할 수 있으며 기존 그룹에서는 수정할 수 없습니다.

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

-MailEnabled

이 그룹이 메일을 사용할 수 있는지 여부를 나타냅니다.

현재 Azure AD 메일 사용 그룹을 만들 수 없습니다.

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

-MailNickname

그룹의 메일 애칭을 지정합니다. MailEnabled가 $False 경우에도 메일 애칭을 지정해야 합니다.

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

-SecurityEnabled

그룹이 보안을 사용할 수 있는지 여부를 나타냅니다. 보안 그룹의 경우 이 값은 $True 합니다.

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

-Visibility

그룹 콘텐츠 및 멤버 목록의 표시 유형을 지정합니다. 이 매개 변수는 다음 값 중 하나를 사용할 수 있습니다.

  • "공개" - 누구나 그룹의 콘텐츠를 볼 수 있습니다.
  • "Private" - 멤버만 그룹의 콘텐츠를 볼 수 있습니다.
  • "HiddenMembership" - 구성원만 그룹의 콘텐츠를 볼 수 있으며 구성원, 소유자, 전역/회사 관리자, 사용자 관리자 및 기술 지원팀 관리자만 그룹의 구성원 목록을 볼 수 있습니다.

값이 제공되지 않으면 기본값은 "Public"이 됩니다.

참고:

  • 이 매개 변수는 groupType이 "Unified"로 설정된 그룹에만 유효합니다.
  • 그룹에 이 특성이 "HiddenMembership"으로 설정된 경우 나중에 변경할 수 없습니다.
  • 누구나 이 특성이 "공개"로 설정된 그룹에 가입할 수 있습니다. 특성이 Private 또는 HiddenMembership으로 설정된 경우 소유자만 그룹에 새 멤버를 추가할 수 있으며 그룹에 가입하라는 요청은 소유자의 승인이 필요합니다.
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

입력

None

출력

Object

참고

Microsoft Graph PowerShell 로 New-AzureADMSGroup 마이그레이션 가이드 를 참조하세요.

이 cmdlet은 현재 공개 미리 보기로 제공됩니다. cmdlet이 공개 미리 보기에 있는 동안 예기치 않은 영향을 줄 수 있는 cmdlet을 변경할 수 있습니다. 프로덕션 환경에서는 이 cmdlet을 사용하지 않는 것이 좋습니다.