Remove-UnifiedGroupLinks

モジュール:
Exchange PowerShell

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

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

注:

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

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

構文

Default (既定) 

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

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

パラメーター

-Confirm

適用対象: Exchange Online、オンプレミス メールボックス用の組み込みセキュリティ アドオン

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

  • データを破壊するコマンドレット (たとえば、Remove- コマンドレット) には、先に進む前にユーザーにそのコマンドの確認を強制する組み込みの一時停止があります。 これらのコマンドレットでは、正確な構文-Confirm:$falseを使用して、確認プロンプトを省略できます。
  • 他のほとんどのコマンドレット (たとえば、New-* や Set-* コマンドレット) には、組み込みの一時停止はありません。 これらのコマンドレットの場合、値を指定せずに Confirm スイッチを指定すると、一時停止が発生し、続行する前にコマンドの確認を強制されます。

パラメーターのプロパティ

型:SwitchParameter
規定値:None
ワイルドカードのサポート:False
DontShow:False
Aliases:Cf

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-Identity

適用対象: Exchange Online、オンプレミス メールボックス用の組み込みセキュリティ アドオン

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

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

パラメーターのプロパティ

型:UnifiedGroupIdParameter
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:1
必須:True
パイプラインからの値:True
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

-Links

適用対象: Exchange Online、オンプレミス メールボックス用の組み込みセキュリティ アドオン

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

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

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

Update 値にスペースを含める、または引用符を必要とする場合は、次の構文を使用します: "Value1","Value2",..."ValueN"。

このパラメーターは、LinkType パラメーターと共に使用する必要があります。つまり、指定した受信者が Microsoft 365 グループ内の同じ役割から削除されます (同じコマンドで異なる役割の受信者を削除することはできません)。

型:

RecipientIdParameter[]

規定値:None
ワイルドカードのサポート:False
DontShow:False
(All)
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-LinkType

適用対象: Exchange Online、オンプレミス メールボックス用の組み込みセキュリティ アドオン

LinkType パラメーターは、削除する Microsoft 365 グループ内の受信者の役割を指定します。 有効な値は次のとおりです。

  • メンバー: 会話への参加、Teams チャネルの作成、ファイルでの共同作業、接続された SharePoint サイトの編集を行います。
  • 所有者: メンバーの追加または削除、会話の削除、チーム設定の変更、チームの削除、接続されている SharePoint サイトのフル コントロール。 グループには、最低 1 人の所有者が必要です。
  • サブスクライバー: グループから会話および予定表イベントの通知を受け取る既存のグループ メンバー。 すべてのサブスクライバーはグループのメンバーですが、すべてのメンバーが必ずしもサブスクライバーであるとは限りません (グループの AutoSubscribeNewMembers プロパティの値とメンバーが追加されたタイミングによって異なります)。

このパラメーターは、Links パラメーターと共に使用する必要があります。

パラメーターのプロパティ

型:LinkType
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-WhatIf

適用対象: Exchange Online、オンプレミス メールボックス用の組み込みセキュリティ アドオン

[WhatIf] スイッチは、何も変更を加えずにコマンドが実行する内容を表示します。 このスイッチで値を指定する必要はありません。

パラメーターのプロパティ

型:SwitchParameter
規定値:None
ワイルドカードのサポート:False
DontShow:False
Aliases:wi

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

CommonParameters

このコマンドレットは、共通パラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable をサポートします。 詳細については、「about_CommonParameters」を参照してください。