New-LabelPolicy
このコマンドレットは、セキュリティ/コンプライアンス PowerShell でのみ使用できます。 詳細については、「セキュリティ/コンプライアンス PowerShell」を参照してください。
New-LabelPolicy コマンドレットを使用して、organizationに秘密度ラベル ポリシーを作成します。
以下の構文セクションのパラメーター セットの詳細については、「Exchangeのコマンドレット構文」を参照してください。
構文
New-LabelPolicy
-Name <String>
-Labels <MultiValuedProperty>
[-AdvancedSettings <PswsHashtable>]
[-Comment <String>]
[-Confirm]
[-ExchangeLocation <MultiValuedProperty>]
[-ExchangeLocationException <MultiValuedProperty>]
[-Force]
[-MigrationId <String>]
[-ModernGroupLocation <MultiValuedProperty>]
[-ModernGroupLocationException <MultiValuedProperty>]
[-OneDriveLocation <MultiValuedProperty>]
[-OneDriveLocationException <MultiValuedProperty>]
[-PolicyRBACScopes <MultiValuedProperty>]
[-PublicFolderLocation <MultiValuedProperty>]
[-Setting <PswsHashtable>]
[-Settings <PswsHashtable>]
[-SharePointLocation <MultiValuedProperty>]
[-SharePointLocationException <MultiValuedProperty>]
[-SkypeLocation <MultiValuedProperty>]
[-SkypeLocationException <MultiValuedProperty>]
[-WhatIf]
[<CommonParameters>]
説明
セキュリティ/コンプライアンス PowerShell でこのコマンドレットを使用するには、アクセス許可が割り当てられている必要があります。 詳細については、「Microsoft Purview コンプライアンス センターのアクセス許可」 を参照してください。
例
例 1
New-LabelPolicy -Name "Research and Development" -Labels "R and D","R and D Management"
この例では、R と D、R、D Management という名前の秘密度ラベルを含む、Research and Development という名前の秘密度ラベル ポリシーを作成します。
パラメーター
-AdvancedSettings
適用対象: セキュリティ & コンプライアンス
AdvancedSettings パラメーターを使用すると、秘密度ラベル ポリシーのクライアント固有の機能が有効になります。
このパラメーターは、ポリシーの ID (名前または GUID) で指定し、 ハッシュ テーブルにキーと値のペアを指定します。 詳細設定を削除するには、同じ AdvancedSettings パラメーター構文を使用しますが、null 文字列値を指定します。
このパラメーターで構成する設定の一部は、組み込みのラベル付けをサポートする Office アプリやサービスではなく、Microsoft Purview Information Protection クライアントでのみサポートされます。 これらの一覧については、「Microsoft Purview Information Protection クライアントの詳細設定」を参照してください。
組み込みのラベル付けに対してサポートされている設定:
AttachmentAction: ラベル付けされていないメールは、最も優先度の高いラベルを添付ファイルから継承します。 値を [自動 ] (ラベルを自動的に適用する) または [推奨] (推奨プロンプトとしてユーザーに適用する) に設定します。 例:
New-LabelPolicy -Identity Global -AdvancedSettings @{AttachmentAction="Automatic"}
。 この構成の選択の詳細については、「 電子メールの添付ファイルからのラベル継承を構成する」を参照してください。EnableAudit: Office アプリが秘密度ラベル データを Microsoft 365 監査ソリューションに送信できないようにします。 サポートされているアプリ: Windows 上のWord、Excel、PowerPoint (バージョン 2201 以降)、macOS (バージョン 16.57 以降)、iOS (バージョン 2.57 以降)、Android (バージョン 16.0.14827 以降)。Outlook on Windows (バージョン 2201 以降)、Outlook on the web、macOS、iOS、Android へのロールアウト。 例:
New-LabelPolicy -Identity Global -AdvancedSettings @{EnableAudit="False"}
。EnableRevokeGuiSupport: Office クライアントの秘密度メニューから [トラック & 取り消し] ボタンを削除します。 サポートされているアプリ: Windows 上のWord、Excel、PowerPoint (バージョン 2406 以降)。 例:
New-LabelPolicy -Identity Global -AdvancedSettings @{EnableRevokeGuiSupport="False"}
。 この構成の選択の詳細については、「 ドキュメント アクセスの追跡と取り消し」を参照してください。DisableMandatoryInOutlook: この設定をサポートする Outlook アプリは、Outlook メッセージを必須のラベル付けから除外します。 例:
New-LabelPolicy -Identity Global -AdvancedSettings @{DisableMandatoryInOutlook="True"}
。 この構成の選択の詳細については、「 既定のラベル付けと必須ラベル付けの Outlook 固有のオプション」を参照してください。DisableShowSensitiveContent: ラベルが推奨される原因となった機密性の高いコンテンツを強調表示する Office アプリの場合は、機密コンテンツに関するこれらの強調表示と対応する表示をオフにします。 詳細については、「Office の ファイルとメールに秘密度ラベルが自動的に適用または推奨される」を参照してください。 サポートされているアプリ: Windows 用のWord (バージョン 2311 以降)。 例:
Set-LabelPolicy -Identity Global -AdvancedSettings @{DisableShowSensitiveContent="True"}
OutlookDefaultLabel: この設定をサポートする Outlook アプリは、既定のラベルを適用するか、ラベルを適用しません。 例:
New-LabelPolicy -Identity Global -AdvancedSettings @{OutlookDefaultLabel="None"}
。 この構成の選択の詳細については、「 既定のラベル付けと必須ラベル付けの Outlook 固有のオプション」を参照してください。TeamworkMandatory: この設定をサポートする Outlook アプリと Teams アプリでは、会議の必須ラベル付けを有効または無効にすることができます。 例:
New-LabelPolicy -Identity Global -AdvancedSettings @{TeamworkMandatory="True"}
。 会議のラベル付けの詳細については、「 秘密度ラベルを使用して予定表アイテム、Teams 会議、チャットを保護する」を参照してください。teamworkdefaultlabelid: この設定をサポートする Outlook アプリと Teams アプリでは、既定のラベルが適用されるか、会議にラベルが適用されません。 例:
New-LabelPolicy -Identity Global -AdvancedSettings @{teamworkdefaultlabelid="General"}
。 会議のラベル付けの詳細については、「 秘密度ラベルを使用して予定表アイテム、Teams 会議、チャットを保護する」を参照してください。HideBarByDefault: 秘密度バーをサポートする Office アプリの場合は、長いファイル名を表示する領域が増えるように、ウィンドウ バーのタイトルに秘密度ラベル名を表示しないでください。 ラベル アイコンと色 (構成されている場合) だけが表示されます。 ユーザーはアプリでこの設定を元に戻すことはできません。 例:
New-LabelPolicy -Identity Global -AdvancedSettings @{HideBarByDefault="True"}
さらに、Power BI の場合:
powerbimandatory: Power BI の必須ラベル付け。 例:
New-LabelPolicy -Identity Global -AdvancedSettings @{powerbimandatory="true"}
。 この構成の選択の詳細については、「 Power BI の必須ラベル ポリシー」を参照してください。powerbidefaultlabelid: Power BI コンテンツの既定のラベル。 例:
New-LabelPolicy -Identity Global -AdvancedSettings @{powerbidefaultlabelid="General"}
。 この構成の選択の詳細については、「 Power BI の既定のラベル ポリシー」を参照してください。
型: | PswsHashtable |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Comment
適用対象: セキュリティ & コンプライアンス
Comment パラメーターで、オプションのコメントを指定します。 スペースを含む値を指定する場合は、次のように値を二重引用符 (") で囲んでください。"これは管理者メモです。"
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Confirm
適用対象: セキュリティ & コンプライアンス
Confirm スイッチは、確認プロンプトを表示するか非表示にするかを指定します。 このスイッチがコマンドレットにどのような影響を与えるかは、先に進む前にコマンドレットで確認が必要となるかどうかで決まります。
- データを破壊するコマンドレット (たとえば、Remove- コマンドレット) には、先に進む前にユーザーにそのコマンドの確認を強制する組み込みの一時停止があります。 これらのコマンドレットでは、正確な構文
-Confirm:$false
を使用して、確認プロンプトを省略できます。 - 他のほとんどのコマンドレット (たとえば、New-* や Set-* コマンドレット) には、組み込みの一時停止はありません。 これらのコマンドレットの場合、値なしで Confirm スイッチを指定すると、先に進む前に、一時停止してコマンドを確認する必要があります。
型: | SwitchParameter |
Aliases: | cf |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-ExchangeLocation
適用対象: セキュリティ & コンプライアンス
ExchangeLocation パラメーターは、ポリシーに含めるメールボックスを指定します。 有効な値はメールボックスです。
メールボックスを指定するには、メールボックスを一意に識別する任意の値を使用できます。 例:
- 名前
- 名前
- 識別名 (DN)
- GUID
Update 値にスペースを含める、または引用符を必要とする場合は、次の構文を使用します: "Value1","Value2",..."ValueN"
。
型: | MultiValuedProperty |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-ExchangeLocationException
適用対象: セキュリティ & コンプライアンス
ExchangeLocationException パラメーターは、ExchangeLocation パラメーターの値 All を使用するときに除外するメールボックスを指定します。 有効な値はメールボックスです。
メールボックスを指定するには、メールボックスを一意に識別する任意の値を使用できます。 例:
- 名前
- 名前
- 識別名 (DN)
- GUID
Update 値にスペースを含める、または引用符を必要とする場合は、次の構文を使用します: "Value1","Value2",..."ValueN"
。
型: | MultiValuedProperty |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Force
適用対象: セキュリティ & コンプライアンス
[強制] スイッチは、警告メッセージまたは確認メッセージを非表示にします。 このスイッチで値を指定する必要はありません。
管理者の入力を求めることが不適切な場合に、このスイッチを使用してタスクをプログラムによって実行することができます。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Labels
適用対象: セキュリティ & コンプライアンス
Labels パラメーターは、ポリシーに関連付けられている秘密度ラベルを指定します。 ラベルを一意に識別する任意の値を使用できます。 例:
- 名前
- 識別名 (DN)
- GUID
Update 値にスペースを含める、または引用符を必要とする場合は、次の構文を使用します: "Value1","Value2",..."ValueN"
。
型: | MultiValuedProperty |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-MigrationId
適用対象: セキュリティ & コンプライアンス
このパラメーターは、Microsoft の内部使用のために予約されています。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-ModernGroupLocation
適用対象: セキュリティ & コンプライアンス
ModernGroupLocation パラメーターは、ポリシーに含めるMicrosoft 365 グループを指定します。 Microsoft 365 グループを識別するには、プライマリ SMTP アドレスを使用する必要があります。
Update 値にスペースを含める、または引用符を必要とする場合は、次の構文を使用します: "Value1","Value2",..."ValueN"
。
型: | MultiValuedProperty |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-ModernGroupLocationException
適用対象: セキュリティ & コンプライアンス
このパラメーターは、Microsoft の内部使用のために予約されています。
型: | MultiValuedProperty |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Name
適用対象: セキュリティ & コンプライアンス
Name パラメーターは、ポリシーの一意の名前を指定します。 最大の長さは 64 文字です。 値にスペースが含まれている場合は、値を二重引用符 (") で囲んでください。
型: | String |
配置: | 1 |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-OneDriveLocation
適用対象: セキュリティ & コンプライアンス
このパラメーターは、Microsoft の内部使用のために予約されています。
型: | MultiValuedProperty |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-OneDriveLocationException
適用対象: セキュリティ & コンプライアンス
このパラメーターは、Microsoft の内部使用のために予約されています。
型: | MultiValuedProperty |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-PolicyRBACScopes
適用対象: セキュリティ & コンプライアンス
PolicyRBACScopes パラメーターは、ポリシーに割り当てる管理単位を指定します。 有効な値は、管理単位のMicrosoft Entra ObjectID (GUID 値) です。 複数の値をコンマで区切って指定できます。
管理単位は、Microsoft Entra ID P1 または P2 でのみ使用できます。 管理単位は、Microsoft Graph PowerShell で作成および管理します。
型: | MultiValuedProperty |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-PublicFolderLocation
適用対象: セキュリティ & コンプライアンス
このパラメーターは、Microsoft の内部使用のために予約されています。
型: | MultiValuedProperty |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Setting
適用対象: セキュリティ & コンプライアンス
このパラメーターは、Microsoft の内部使用のために予約されています。
型: | PswsHashtable |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Settings
適用対象: セキュリティ & コンプライアンス
このパラメーターは、Microsoft の内部使用のために予約されています。
型: | PswsHashtable |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-SharePointLocation
適用対象: セキュリティ & コンプライアンス
このパラメーターは、Microsoft の内部使用のために予約されています。
型: | MultiValuedProperty |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-SharePointLocationException
適用対象: セキュリティ & コンプライアンス
このパラメーターは、Microsoft の内部使用のために予約されています。
型: | MultiValuedProperty |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-SkypeLocation
適用対象: セキュリティ & コンプライアンス
このパラメーターは、Microsoft の内部使用のために予約されています。
型: | MultiValuedProperty |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-SkypeLocationException
適用対象: セキュリティ & コンプライアンス
このパラメーターは、Microsoft の内部使用のために予約されています。
型: | MultiValuedProperty |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-WhatIf
適用対象: セキュリティ & コンプライアンス
WhatIf スイッチは、セキュリティ/コンプライアンス PowerShell では機能しません。
型: | SwitchParameter |
Aliases: | wi |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |