다음을 통해 공유


Microsoft.Graph 그룹

사용 권한

이 API에 대해 최소 권한으로 표시된 사용 권한 또는 사용 권한을 선택합니다. 앱에 필요한 경우에만 더 높은 권한 사용 권한 또는 사용 권한을 사용합니다. 위임된 권한 및 애플리케이션 권한에 대한 자세한 내용은 사용 권한 유형을 참조 하세요. 이러한 권한에 대한 자세한 내용은 사용 권한 참조참조하세요.

참고 항목

개인 Microsoft 계정에 대한 사용 권한은 Bicep 파일에 선언된 Microsoft Graph 리소스를 배포하는 데 사용할 수 없습니다.

권한 유형 최소 권한 더 높은 권한 사용 권한
위임됨(회사 또는 학교 계정) Group.ReadWrite.All Directory.ReadWrite.All
위임됨 (개인 Microsoft 계정) 지원 안 됨 지원 안 됨
애플리케이션 Group.ReadWrite.All Directory.ReadWrite.All

리소스 형식

Microsoft.Graph/groups 리소스를 만들려면 템플릿에 다음 Bicep을 추가합니다.

resource symbolicname 'Microsoft.Graph/groups@v1.0' = {
  classification: 'string'
  description: 'string'
  displayName: 'string'
  groupTypes: [
    'string'
  ]
  isAssignableToRole: bool
  mailEnabled: bool
  mailNickname: 'string'
  members: [
    'string'
  ]
  membershipRule: 'string'
  membershipRuleProcessingState: 'string'
  owners: [
    'string'
  ]
  preferredDataLocation: 'string'
  preferredLanguage: 'string'
  securityEnabled: bool
  serviceProvisioningErrors: [
    {
      createdDateTime: 'string'
      isResolved: bool
      serviceInstance: 'string'
    }
  ]
  theme: 'string'
  uniqueName: 'string'
  visibility: 'string'
}

속성 값

그룹

속성 설명
apiVersion 리소스 api 버전 'v1.0'(ReadOnly)
분류 그룹에 대한 분류(예: 낮은, 중간 또는 높은 비즈니스 영향)를 설명합니다. string
createdDateTime 그룹을 만든 시기의 타임스탬프입니다. 값을 수정할 수 없으며 그룹을 만들 때 자동으로 채워집니다. 타임스탬프 형식은 ISO 8601 형식을 사용하는 날짜 및 시간 정보를 나타내며 항상 UTC 시간입니다. 예를 들어 2014년 1월 1일 자정 UTC는 2014-01-01T00:00:00Z입니다. 읽기 전용. string(ReadOnly)
deletedDateTime 이 개체가 삭제된 날짜 및 시간입니다. 개체가 삭제되지 않은 경우 항상 null입니다. string(ReadOnly)
description 그룹에 대한 선택적 설명 string
displayName 그룹의 표시 이름입니다. 이 속성은 그룹을 만들 때 필요하며 업데이트 중에 지울 수 없습니다. 최대 길이는 256자입니다. string(필수)
expirationDateTime 그룹이 만료되도록 설정된 시기의 타임스탬프입니다. 보안 그룹의 경우 null이지만 Microsoft 365 그룹의 경우 groupLifecyclePolicy에 정의된 대로 그룹이 만료되도록 설정된 시기를 나타냅니다. 타임스탬프 형식은 ISO 8601 형식을 사용하는 날짜 및 시간 정보를 나타내며 항상 UTC로 표시됩니다. 예를 들어 2014년 1월 1일 자정 UTC는 2014-01-01T00:00:00Z입니다. 읽기 전용. string(ReadOnly)
groupTypes 그룹 유형 및 해당 멤버 자격을 지정합니다. 컬렉션에 Unified가 포함된 경우 그룹은 Microsoft 365 그룹입니다. 그렇지 않으면 보안 그룹 또는 메일 그룹입니다. 자세한 내용은 그룹 개요를 참조하세요. 컬렉션에 DynamicMembership이 포함된 경우 그룹에는 동적 멤버 자격이 있습니다. 그렇지 않으면 멤버 자격이 정적입니다. string[]
id 엔터티의 고유 식별자입니다. 읽기 전용. string(ReadOnly)
isAssignableToRole 이 그룹을 Microsoft Entra 역할에 할당할 수 있는지 여부를 나타냅니다. 선택 사항. 이 속성은 그룹을 만드는 동안에만 설정할 수 있으며 변경할 수 없습니다. true로 설정하면 securityEnabled 속성도 true로 설정해야 하고 표시 유형은 숨김이어야 하며 그룹은 동적 그룹이 될 수 없습니다(즉, groupTypes에 DynamicMembership을 포함할 수 없음). 최소 권한 있는 역할 관리자 역할이 있는 호출자만 이 속성을 설정할 수 있습니다. 이 속성을 설정하거나 이러한 그룹의 멤버 자격을 업데이트하려면 호출자에게 RoleManagement.ReadWrite.Directory 권한도 할당되어야 합니다. 자세한 내용은 그룹을 사용하여 Microsoft Entra 역할 할당 관리 참조 이 기능을 사용하려면 Microsoft Entra ID P1 라이선스가 필요합니다. bool
mail 그룹의 SMTP 주소(예: ''serviceadmins@contoso.com)입니다. 읽기 전용 string(ReadOnly)
mailEnabled 그룹이 메일을 사용할 수 있는지 여부를 지정합니다. Required bool(필수)
mailNickname 그룹의 메일 별칭으로, 조직의 Microsoft 365 그룹에 대해 고유합니다. 최대 길이는 64자입니다. 이 속성은 다음 문자를 제외하고 ASCII 문자 집합 0 - 127의 문자만 포함할 수 있습니다. @ () / [] ' ; : <> , SPACE. Required string(필수)
구성원 사용자, 디바이스, 기타 그룹 또는 서비스 주체일 수 있는 이 그룹의 구성원입니다. 멤버 나열, 멤버 추가 및 멤버 제거 작업을 지원합니다. Nullable string[]
membershipRule 그룹이 동적 그룹인 경우 이 그룹의 멤버를 결정하는 규칙입니다(groupTypes에 DynamicMembership 포함). 멤버 자격 규칙의 구문에 대한 자세한 내용은 멤버 자격 규칙 구문을 참조하세요. string
membershipRuleProcessingState 동적 멤버 자격 처리가 켜지거나 일시 중지되었는지 여부를 나타냅니다. 가능한 값은 켜기 또는 일시 중지됨 string
onPremisesDomainName string(ReadOnly)
onPremisesLastSyncDateTime 그룹이 온-프레미스 디렉터리와 동기화된 마지막 시간을 나타냅니다. 타임스탬프 형식은 ISO 8601 형식을 사용하는 날짜 및 시간 정보를 나타내며 항상 UTC 시간입니다. 예를 들어 2014년 1월 1일 자정 UTC는 2014-01-01T00:00:00Z입니다. 읽기 전용 string(ReadOnly)
onPremisesNetBiosName string(ReadOnly)
onPremisesProvisioningErrors 프로비전 중 Microsoft 동기화 제품을 사용할 때 오류 발생 MicrosoftGraphOnPremisesProvisioningError[] (ReadOnly)
onPremisesSamAccountName 온-프레미스 디렉터리에서 동기화된 온-프레미스 SAM 계정 이름을 포함합니다. 읽기 전용. string(ReadOnly)
onPremisesSecurityIdentifier 온-프레미스에서 클라우드로 동기화된 그룹의 온-프레미스 SID(보안 식별자)를 포함합니다. 읽기 전용 string(ReadOnly)
onPremisesSyncEnabled 이 그룹이 온-프레미스 디렉터리에서 동기화된 경우 true입니다. 이 그룹이 원래 온-프레미스 디렉터리에서 동기화되었지만 더 이상 동기화되지 않은 경우 false입니다. 이 개체가 온-프레미스 디렉터리(기본값)에서 동기화되지 않은 경우 null입니다. 읽기 전용 bool(ReadOnly)
owners 그룹의 소유자입니다. 소유자 100명으로 제한됩니다. Nullable. Microsoft 365 그룹을 만들 때 이 속성을 지정하지 않으면 호출하는 사용자가 자동으로 그룹 소유자로 할당됩니다. string[]
preferredDataLocation Microsoft 365 그룹의 기본 설정 데이터 위치입니다. 기본적으로 그룹은 그룹 작성자의 기본 설정 데이터 위치를 상속합니다. 이 속성을 설정하려면 호출 앱에 Directory.ReadWrite.All 권한이 부여되고 사용자에게 다음 Microsoft Entra 역할 중 하나 이상이 할당되어야 합니다. 사용자 계정 관리자 디렉터리 기록기 Exchange 관리자 SharePoint 관리자 이 속성에 대한 자세한 내용은 OneDrive Online Multi-Geo를 참조하세요. Nullable string
preferredLanguage Microsoft 365 그룹의 기본 설정 언어입니다. ISO 639-1 코드를 따라야 합니다. 예: en-US string
proxyAddresses 동일한 그룹 사서함으로 전송되는 그룹의 전자 메일 주소입니다. 예: ['SMTP: bob@contoso.com', 'smtp: bob@sales.contoso.com']. 모든 연산자는 다중값 속성에 대한 식을 필터링하는 데 필요합니다. 읽기 전용. nullable이 아님 string[] (ReadOnly)
renewedDateTime 그룹이 마지막으로 갱신된 시기의 타임스탬프입니다. 이 값은 직접 수정할 수 없으며 서비스 갱신 작업을 통해서만 업데이트됩니다. 타임스탬프 형식은 ISO 8601 형식을 사용하는 날짜 및 시간 정보를 나타내며 항상 UTC로 표시됩니다. 예를 들어 2014년 1월 1일 자정 UTC는 2014-01-01T00:00:00Z입니다. 읽기 전용. string(ReadOnly)
securityEnabled 그룹이 보안 그룹인지 여부를 지정합니다. Required bool(필수)
securityIdentifier Windows 시나리오에서 사용되는 그룹의 보안 식별자입니다. 읽기 전용 string(ReadOnly)
serviceProvisioningErrors 그룹 개체의 속성 또는 링크와 관련된 비전환 서비스별 오류를 설명하는 페더레이션된 서비스에서 게시한 오류 MicrosoftGraphServiceProvisioningError[]
테마 Microsoft 365 그룹의 색 테마를 지정합니다. 가능한 값은 청록색, 자주색, 녹색, 파랑, 분홍색, 주황색 또는 빨강입니다. string
type 리소스 종류 'Microsoft.Graph/groups'(ReadOnly)
uniqueName 그룹에 할당하고 대체 키로 사용할 수 있는 고유 식별자입니다. 변경 불가능 string(필수)
visibility 그룹에 대한 그룹 조인 정책 및 그룹 콘텐츠 표시 유형을 지정합니다. 가능한 값은 Private, Public 또는 HiddenMembership입니다. HiddenMembership은 그룹을 만들 때 Microsoft 365 그룹에 대해서만 설정할 수 있습니다. 나중에 업데이트할 수 없습니다. 그룹을 만든 후에 다른 표시 유형 값을 업데이트할 수 있습니다. Microsoft Graph에서 그룹을 만드는 동안 표시 유형 값을 지정하지 않으면 보안 그룹이 기본적으로 Private으로 생성되고 Microsoft 365 그룹은 Public입니다. 역할에 할당할 수 있는 그룹은 항상 비공개입니다. 자세한 내용은 그룹 표시 유형 옵션을 참조하세요. Nullable. string

MicrosoftGraphOnPremisesProvisioningError

속성 설명
category 프로비전 오류의 범주입니다. 참고: 현재 가능한 값은 하나뿐입니다. 가능한 값: PropertyConflict - 속성 값이 고유하지 않음을 나타냅니다. 다른 개체는 속성에 대해 동일한 값을 포함합니다. string
occurredDateTime 오류가 발생한 날짜 및 시간입니다. string
propertyCausingError 오류를 일으키는 디렉터리 속성의 이름입니다. 현재 가능한 값: UserPrincipalName 또는 ProxyAddress string
value 오류를 일으키는 속성의 값입니다. string

MicrosoftGraphServiceProvisioningError

속성 설명
createdDateTime 오류가 발생한 날짜 및 시간입니다. string
isResolved 오류가 발생했는지 여부를 나타냅니다. bool
serviceInstance 서비스 오류 정보를 게시한 정규화된 서비스 인스턴스(예: 'SharePoint/Dublin')입니다. string