Remove-VivaModuleFeaturePolicy

このコマンドレットは、Exchange Online PowerShell モジュール バージョン 3.2.0 以降でのみ使用できます。 詳細については、「Exchange Online PowerShell モジュールについて」を参照してください。

Remove-VivaModuleFeaturePolicy コマンドレットを使用して、Viva の Viva モジュールの機能のアクセス ポリシーを削除します。 ポリシーを削除すると、ポリシーは完全に削除されます。 削除を元に戻すことはできません。

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

構文

Default (既定)

Remove-VivaModuleFeaturePolicy
    -FeatureId <String>
    -ModuleId <String>
    -PolicyId <String>
    [-Confirm]
    [-ResultSize <Unlimited>]
    [-WhatIf]
    [<CommonParameters>]

説明

Remove-VivaModuleFeaturePolicy コマンドレットを使用して、Viva の Viva モジュールの機能のアクセス ポリシーを削除します。

認証には、Connect-ExchangeOnline コマンドレットを使用する必要があります。

このコマンドレットには、.NET Framework 4.7.2 以降が必要です。

現時点では、このコマンドレットを実行するには、グローバル管理者ロールのメンバーであるか、機能レベルで割り当てられているロールである必要があります。

機能レベルで割り当てられたロールの詳細については、「 機能アクセス管理で使用できる機能」を参照してください。

Microsoft Entra IDでの管理者ロールのアクセス許可の詳細については、「ロール テンプレート ID」を参照してください。

重要

Microsoft では、最小限のアクセス許可の原則を強くお勧めします。 アカウントにタスクを実行するために必要な最小限のアクセス許可のみを割り当てることは、セキュリティ リスクを軽減し、組織の全体的な保護を強化するのに役立ちます。 グローバル管理者は、通常、緊急シナリオや別のロールを使用できない場合に制限する高い特権を持つロールです。

例 1

Remove-VivaModuleFeaturePolicy -ModuleId VivaInsights -FeatureId Reflection -PolicyId 3db38dfa-02a3-4039-b33a-42b0b3da029b

次の使用例は、Viva Insights のリフレクション機能に指定されたポリシーを削除します。

パラメーター

-Confirm

適用対象: Exchange Online

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

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

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

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

パラメーター セット

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

-FeatureId

適用対象: Exchange Online

FeatureId パラメーターは、ポリシーを削除する Viva モジュールの機能を指定します。

機能アクセス制御をサポートする Viva モジュールの機能の詳細を表示するには、Get-VivaModuleFeature コマンドレットを使用します。 FeatureId 値は、コマンドレットの出力で返されます。

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

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

パラメーター セット

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

-ModuleId

適用対象: Exchange Online

ModuleId パラメーターは、ポリシーを削除する機能の Viva モジュールを指定します。

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

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

パラメーター セット

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

-PolicyId

適用対象: Exchange Online

PolicyId パラメーターは、削除する Viva モジュールの機能のポリシーを指定します。

Viva モジュールの機能に対して追加されたポリシーの詳細を表示するには、Get-VivaModuleFeaturePolicy コマンドレットを参照してください。 Get-VivaModuleFeaturePolicy コマンドレットによって提供される詳細には、ポリシー識別子が含まれます。

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

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

パラメーター セット

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

-ResultSize

適用対象: Exchange Online

このパラメーターは、Microsoft の内部使用のために予約されています。

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

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

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値: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」を参照してください。