Remove-AuthenticationPolicy
このコマンドレットは、オンプレミスの Exchange およびクラウド ベースのサービスで使用できます。 一部のパラメーターおよび設定は、いずれかの環境専用となっている場合があります。
Remove-AuthenticationPolicy コマンドレットを使用して、organizationから認証ポリシーを削除します。
以下の構文セクションのパラメーター セットの詳細については、「Exchangeのコマンドレット構文」を参照してください。
構文
Remove-AuthenticationPolicy
[-Identity] <AuthPolicyIdParameter>
[-Confirm]
[-AllowLegacyExchangeTokens]
[-TenantId <String>]
[-WhatIf]
[<CommonParameters>]
説明
このコマンドレットを実行する際には、あらかじめアクセス許可を割り当てる必要があります。 このトピックにはこのコマンドレットのすべてのパラメーターが一覧表示されていますが、自分に割り当てられているアクセス許可に含まれていない一部のパラメーターにはアクセスできません。 コマンドレットを組織内で実行するために必要になるアクセス許可とパラメーターを調べるには、「 Find the permissions required to run any Exchange cmdlet」を参照してください。
例
例 1
Remove-AuthenticationPolicy -Identity "Engineering Group"
この例では、"Engineering Group" という名前の認証ポリシーを削除します。
例 2
Remove-AuthenticationPolicy -Identity "LegacyExchangeTokens" -AllowLegacyExchangeTokens
Exchange Onlineでは、この例では、従来の Exchange トークンを Outlook アドインに発行できるようにします。このスイッチは、organization全体に適用されます。 Identity パラメーターは必須であり、その値は "LegacyExchangeTokens" に設定する必要があります。 特定の認証ポリシーを適用することはできません。
パラメーター
-AllowLegacyExchangeTokens
このパラメーターは、クラウドベースのサービスでのみ使用できます。
AllowLegacyExchangeTokens スイッチを使用すると、organizationの従来の Exchange トークンを Outlook アドインに発行できます。 このスイッチで値を指定する必要はありません。
従来の Exchange トークンには、Exchange ユーザー ID とコールバック トークンが含まれます。
このスイッチは、organization全体に適用されます。 Identity パラメーターは必須であり、その値は "LegacyExchangeTokens" に設定する必要があります。 特定の認証ポリシーを適用することはできません。
重要:
- ID パラメーターとは別に、このスイッチは同じコマンドで使用される他の認証ポリシー パラメーターを無視します。 その他の認証ポリシーの変更には、個別のコマンドを実行することをお勧めします。
- 変更がorganization全体で有効になるまでに最大 24 時間かかる場合があります。
- トークン ブロックがorganizationに実装される前に Outlook アドインに発行されたレガシ Exchange トークンは、有効期限が切れるまで有効なままになります。
- レガシ Exchange トークンは、最終的にすべてのクラウドベースの組織で既定でブロックされます。 詳細については、「 入れ子になったアプリ認証」と「Outlook レガシ トークンの非推奨に関する FAQ」を参照してください。
型: | SwitchParameter |
配置: | Named |
規定値: | True |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
適用対象: | Exchange Online, Exchange Online Protection |
-Confirm
Confirm スイッチは、確認プロンプトを表示するか非表示にするかを指定します。 このスイッチがコマンドレットにどのような影響を与えるかは、先に進む前にコマンドレットで確認が必要となるかどうかで決まります。
- データを破壊するコマンドレット (たとえば、Remove- コマンドレット) には、先に進む前にユーザーにそのコマンドの確認を強制する組み込みの一時停止があります。 これらのコマンドレットでは、正確な構文
-Confirm:$false
を使用して、確認プロンプトを省略できます。 - 他のほとんどのコマンドレット (たとえば、New-* や Set-* コマンドレット) には、組み込みの一時停止はありません。 これらのコマンドレットの場合、値なしで Confirm スイッチを指定すると、先に進む前に、一時停止してコマンドを確認する必要があります。
型: | SwitchParameter |
Aliases: | cf |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
適用対象: | Exchange Server 2019, Exchange Online, Exchange Online Protection |
-Identity
Identity パラメーターは、削除する認証ポリシーを指定します。 ポリシーを一意に識別する任意の値を使用できます。 次に例を示します。
- 名前
- 識別名 (DN)
- GUID
型: | AuthPolicyIdParameter |
配置: | 0 |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
適用対象: | Exchange Server 2019, Exchange Online, Exchange Online Protection |
-TenantId
このパラメーターは、クラウドベースのサービスでのみ使用できます。
{{ Fill TenantId Description }}
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
適用対象: | Exchange Online, Exchange Online Protection |
-WhatIf
WhatIf スイッチは、コマンドの操作をシミュレートします。 このスイッチを使用すると、実際にその変更内容を適用せずに、発生する変更を確認できます。 このスイッチで値を指定する必要はありません。
型: | SwitchParameter |
Aliases: | wi |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
適用対象: | Exchange Server 2019, Exchange Online, Exchange Online Protection |