Remove-UnifiedGroupLinks

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

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

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

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

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

構文

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

説明

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

このコマンドレットを実行する際には、あらかじめアクセス許可を割り当てる必要があります。 このトピックにはこのコマンドレットのすべてのパラメーターが一覧表示されていますが、自分に割り当てられているアクセス許可に含まれていない一部のパラメーターにはアクセスできません。 コマンドレットを組織内で実行するために必要になるアクセス許可とパラメーターを調べるには、「 Find the permissions required to run any Exchange cmdlet」を参照してください。

例

例 1

Remove-UnifiedGroupLinks -Identity "Legal Department" -LinkType Members -Links laura@contoso.com,julia@contoso.com

この例では、Office Department という名前の Microsoft 365 グループからメンバー laura@contoso.com と julia@contoso.com を削除します。

パラメーター

-Confirm

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

  • 破壊的なコマンドレット (Remove-* コマンドレットなど) には、続行する前にコマンドの確認を強制する組み込みの一時停止があります。 これらのコマンドレットでは、正確な構文-Confirm:$falseを使用して、確認プロンプトを省略できます。
  • 他のほとんどのコマンドレット (New-* コマンドレットや Set-* コマンドレットなど) には、一時停止が組み込まれています。 これらのコマンドレットの場合、値なしで Confirm スイッチを指定すると、先に進む前に、一時停止してコマンドを確認する必要があります。
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 グループを一意に識別する任意の値を使用できます。 例:

  • 名前
  • Alias
  • 識別名 (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 パラメーターを使用して、これらの受信者がメンバー、所有者、またはサブスクライバーであるかどうかを指定します。

受信者を一意に識別する任意の値を使用できます。 たとえば、次の値を使用できます。

  • 名前
  • Alias
  • 識別名 (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 サイトのフル コントロール。 グループには、最低 1 人の所有者が必要です。
  • サブスクライバー: グループから会話と予定表のイベント通知を受け取るメンバー。 すべてのサブスクライバーはグループのメンバーですが、すべてのメンバーが必ずしもサブスクライバーであるとは限りません (グループの AutoSubscribeNewMembers プロパティの値とメンバーが追加されたタイミングに応じて異なります)。

このパラメーターは、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