Add-UnifiedGroupLinks

  • リファレンス
モジュール:
ExchangePowerShell
適用対象:
Exchange Online, Exchange Online Protection

このコマンドレットは、クラウドベースのサービスでのみ使用できます。

Add-UnifiedGroupLinks コマンドレットを使用して、クラウドベースの組織のMicrosoft 365 グループにメンバー、所有者、サブスクライバーを追加します。 メンバー、所有者、サブスクライバーを削除するには、Remove-UnifiedGroupLinks コマンドレットを使用します。 Microsoft 365 グループの他のプロパティを変更するには、Set-UnifiedGroup コマンドレットを使用します。

注: 証明書ベースの認証 (無人スクリプトの場合は CBA またはアプリ専用認証とも呼ばれます) を使用して接続する場合は、このコマンドレットを使用してグループのメンバー、所有者、サブスクライバー Microsoft 365を変更することはできません。 代わりに Microsoft Graphを使用できます。 詳細については、「 グループ リソースの種類」を参照してください。

以下の構文セクションのパラメーター セットの詳細については、「Exchangeのコマンドレット構文」を参照してください。

構文

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

説明

Microsoft 365 グループは、Microsoft 365 サービス間で使用できるグループ オブジェクトです。

このコマンドレットを実行する際には、あらかじめアクセス許可を割り当てる必要があります。このトピックにはこのコマンドレットのすべてのパラメーターが一覧表示されていますが、自分に割り当てられているアクセス許可に含まれていない一部のパラメーターにはアクセスできません。組織内のコマンドレットまたはパラメーターの実行に必要なアクセス許可を検索するには、「Exchange コマンドレットを実行するために必要なパーミッションを検索する」 をご覧ください。

注: グループの所有者にできるのはメンバーのみであるため、最初にユーザーをメンバーとして追加してから、そのユーザーを所有者として追加する必要があります。 ゲスト ユーザーは、グループのメンバーである場合でも、グループの所有者にすることはできません。

例

例 1

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

次の使用例は、chris@contoso.com メンバーと michelle@contoso.com を法務部という名前のMicrosoft 365 グループに追加します。

例 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 グループに一括メンバーを追加する方法を示します。 Department 属性が "Marketing" であるメールボックスは、Marketing という名前のMicrosoft 365 グループに追加されます。

パラメーター

-Confirm

Confirm スイッチは、確認プロンプトを表示するか非表示にするかを指定します。 このスイッチがコマンドレットにどのような影響を与えるかは、先に進む前にコマンドレットで確認が必要となるかどうかで決まります。

  • データを破壊するコマンドレット (たとえば、Remove-* コマンドレット) には、先に進む前にユーザーにそのコマンドの確認を強制する組み込みの一時停止があります。 これらのコマンドレットでは、正確な構文-Confirm:$falseを使用して、確認プロンプトを省略できます。
  • 他のほとんどのコマンドレット (たとえば、New-* や Set-* コマンドレット) には、組み込みの一時停止はありません。 これらのコマンドレットの場合、値なしで Confirm スイッチを指定すると、先に進む前に、一時停止してコマンドを確認する必要があります。
Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection
-Identity

Identity パラメーターは、変更するMicrosoft 365 グループを指定します。 Microsoft 365 グループを一意に識別する任意の値を使用できます。 例:

  • 名前
  • Alias
  • 識別名 (DN)
  • 正規 DN
  • 電子メール アドレス
  • GUID
Type:UnifiedGroupIdParameter
Position:1
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection
-Links

Links パラメーターは、Microsoft 365 グループに追加する受信者を指定します。 これらの受信者がメンバー、所有者、またはサブスクライバーであるかどうかを指定するには、LinkType パラメーターを使用します。

受信者を一意に識別する任意の値を使用できます。 例:

  • 名前
  • Alias
  • 識別名 (DN)
  • 正規 DN
  • 電子メール アドレス
  • GUID

Update 値にスペースが含まれているか、引用符が必要な場合は、次の構文を使用します "Value1","Value2",..."ValueN"。

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

LinkType パラメーターは、変更する Microsoft 365 Group プロパティを指定します。 有効な値は次のとおりです。

  • アグリゲーター
  • メンバー
  • 所有者
  • サブスクライバー
Type:LinkType
Position:Named
Default value:None
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
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection