Add-UnifiedGroupLinks

참조

모듈:: ExchangePowerShell

적용 대상:: Exchange Online, Exchange Online Protection

이 cmdlet은 클라우드 기반 서비스에서만 사용할 수 있습니다.

Add-UnifiedGroupLinks cmdlet을 사용하여 클라우드 기반 조직의 Microsoft 365 그룹 멤버, 소유자 및 구독자를 추가합니다. 멤버, 소유자 및 구독자를 제거하려면 Remove-UnifiedGroupLinks cmdlet을 사용합니다. Microsoft 365 그룹 다른 속성을 수정하려면 Set-UnifiedGroup cmdlet을 사용합니다.

참고: 인증서 기반 인증(무인 스크립트의 경우 CBA 또는 앱 전용 인증이라고도 함) 또는 Azure 관리 ID를 사용하여 연결하는 경우 이 cmdlet을 사용하여 Microsoft 365 그룹 구성원, 소유자 또는 구독자를 수정할 수 없습니다. Microsoft Graph Explorer를 사용하여 다음을 수행할 수 있습니다. 자세한 내용은 그룹 리소스 종류를 참조하세요.

아래 구문 섹션에 있는 매개 변수 집합에 대한 자세한 내용은 Exchange cmdlet 구문을 참조하십시오.

Syntax

Add-UnifiedGroupLinks
   [-Identity] <UnifiedGroupIdParameter>
   -Links <RecipientIdParameter[]>
   -LinkType <LinkType>
   [-Confirm]
   [-WhatIf]
   [<CommonParameters>]

Description

Microsoft 365 그룹 Microsoft 365 서비스에서 사용할 수 있는 그룹 개체입니다.

이 cmdlet을 실행하려면 먼저 사용 권한을 할당받아야 합니다. 이 항목에는 해당 cmdlet의 모든 매개 변수가 나열되지만 사용자에게 할당된 사용 권한에 포함되지 않은 일부 매개 변수에는 액세스할 수 없습니다. 조직에서 cmdlet 또는 매개 변수를 실행하는 데 필요한 사용 권한을 확인하려면 Find the permissions required to run any Exchange cmdlet를 참조하세요.

참고: 구성원만 그룹의 소유자가 될 수 있으므로 먼저 사용자를 소유자로 추가하기 전에 구성원으로 추가해야 합니다. 게스트 사용자는 그룹의 구성원인 경우에도 그룹의 소유자가 될 수 없습니다.

예제

예 1

Add-UnifiedGroupLinks -Identity "Legal Department" -LinkType Members -Links chris@contoso.com,michelle@contoso.com

다음은 법률 부서라는 Microsoft 365 그룹에 구성원 chris@contoso.com 및 michelle@contoso.com 를 추가하는 예제입니다.

예 2

$users= Get-User -ResultSize unlimited | where {$_.Department -eq "Marketing" -AND $_.RecipientType -eq "UserMailbox"}

Add-UnifiedGroupLinks -Identity Marketing -LinkType members -Links ($users.UserPrincipalName)

이 예제에서는 Microsoft 365 그룹에 대량 멤버를 추가하는 방법을 보여줍니다. 부서 특성이 "마케팅"인 사서함은 Marketing이라는 Microsoft 365 그룹에 추가됩니다.

매개 변수

-Confirm

Confirm 스위치는 확인 메시지를 표시할지 여부를 지정합니다. 진행하기 전에 cmdlet이 확인을 요구하는지에 따라 이 스위치가 cmdlet에 미치는 영향이 달라집니다.

파괴적인 cmdlet(예: Remove-* cmdlet)에는 계속하기 전에 명령을 강제로 승인하도록 하는 기본 제공 일시 중지가 있습니다. 이러한 cmdlet의 경우 정확한 구문 -Confirm:$false를 사용하여 확인 메시지를 건너뛸 수 있습니다.
대부분의 다른 cmdlet(예: New-* 및 Set-* cmdlet)에는 기본 제공 일시 중지가 없습니다. 이러한 cmdlet의 경우 값 없이 스위치를 지정하면 계속하기 전에 명령을 강제로 확인하도록 하는 일시 중지가 추가됩니다.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-Identity

Identity 매개 변수는 수정하려는 Microsoft 365 그룹을 지정합니다. Microsoft 365 그룹을 고유하게 식별하는 모든 값을 사용할 수 있습니다. 예시:

이름
별칭
DN(고유 이름)
DN(고유 이름)
정식 DN
GUID

Type:	UnifiedGroupIdParameter
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-Links

Links 매개 변수는 Microsoft 365 그룹에 추가할 받는 사람을 지정합니다. LinkType 매개 변수를 사용하여 이러한 수신자가 멤버, 소유자 또는 구독자인지 여부를 지정합니다.

받는 사람을 고유하게 식별하는 모든 값을 사용할 수 있습니다. 예:

이름
별칭
DN(고유 이름)
DN(고유 이름)
정식 DN
GUID

Update 값에 공백이 포함되거나 따옴표가 필요한 경우 다음 구문을 "Value1","Value2",..."ValueN"사용합니다.

LinkType 매개 변수와 함께 이 매개 변수를 사용해야 합니다. 즉, 지정된 받는 사람이 모두 Microsoft 365 그룹에서 동일한 역할을 받습니다(동일한 명령에서 다른 역할을 가진 받는 사람을 추가할 수 없음).

Type:	RecipientIdParameter[]
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-LinkType

LinkType 매개 변수는 추가할 Microsoft 365 그룹에서 받는 사람의 역할을 지정합니다. 유효한 값은 다음과 같습니다.

구성원: 대화에 참여하고, Teams 채널을 만들고, 파일에 대해 공동 작업하고, 연결된 SharePoint 사이트를 편집합니다.
소유자: 구성원 추가 또는 제거, 대화 삭제, 팀 설정 변경, 팀 삭제 및 연결된 SharePoint 사이트의 모든 권한 그룹에는 소유자가 한 명 이상 있어야 합니다.
구독자: 그룹에서 대화 및 일정 이벤트 알림을 받는 멤버입니다. 모든 구독자는 그룹의 구성원이지만 모든 멤버가 반드시 구독자가 되는 것은 아닙니다(그룹의 AutoSubscribeNewMembers 속성 값과 멤버가 추가된 시기에 따라 다름).

PowerShell에서 그룹에 추가하려는 소유자 또는 구독자도 구성원이어야 합니다.

LinkType 매개 변수와 함께 이 매개 변수를 사용해야 합니다.

Type:	LinkType
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-WhatIf

Whatif 스위치는 해당 명령의 동작을 시뮬레이션합니다. 이 스위치를 사용하면 변경 내용을 실제로 적용하지 않고 발생할 변경 내용을 확인할 수 있습니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

다음을 통해 공유