Remove-EntraGroup

モジュール:
Microsoft.Entra.Groups Module v1.3

グループを削除します。

構文

Default (既定) 

Remove-EntraGroup

    -GroupId <String>
    [<CommonParameters>]

説明

Remove-EntraGroup コマンドレットは、Microsoft Entra IDからグループを削除します。 グループを削除する GroupId パラメーターを指定します。

統合グループは、 Restore-EntraBetaDeletedDirectoryObject コマンドレットを使用して、削除から 30 日後に復元できます。 削除後にセキュリティ グループを復元することはできません。

アクセス許可に関する注意事項:

アプリがロール割り当て可能なグループを削除するには、次の条件が適用されます。

  • 委任されたシナリオでは、アプリにRoleManagement.ReadWrite.Directory委任されたアクセス許可が割り当てられている必要があります。また、呼び出し元のユーザーがグループの作成者であるか、少なくとも特権ロール管理者Microsoft Entraロールが割り当てられている必要があります。
  • アプリのみのシナリオでは、呼び出し元アプリがグループの所有者であるか、RoleManagement.ReadWrite.Directory アプリケーションのアクセス許可が割り当てられているか、少なくとも特権ロール管理者Microsoft Entraロールが割り当てられている必要があります。

例

例 1: グループを削除する

Connect-Entra -Scopes 'Group.ReadWrite.All'
$group = Get-EntraGroup -Filter "DisplayName eq 'HelpDesk Team Leaders'"
Remove-EntraGroup -GroupId $group.Id

この例では、Microsoft Entra IDでグループを削除する方法を示します。

  • GroupId パラメーターはグループ ID を指定します。

例 2: パイプライン処理を使用してグループを削除する

Connect-Entra -Scopes 'Group.ReadWrite.All'
Get-EntraGroup -Filter "DisplayName eq 'HelpDesk Team Leaders'" | Remove-EntraGroup

この例では、Microsoft Entra IDでグループを削除する方法を示します。

パラメーター

-GroupId

Microsoft Entra IDのグループのオブジェクト ID を指定します。

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

型:System.String
規定値:None
ワイルドカードのサポート:False
DontShow:False
Aliases:オブジェクト識別子

パラメーター セット

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

CommonParameters

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