New-LabelPolicy
このコマンドレットは、セキュリティ & コンプライアンス PowerShell でのみ使用できます。 詳細については、「 セキュリティ & コンプライアンス PowerShell」を参照してください。
New-LabelPolicy コマンドレットを使用して、組織内に秘密度ラベル ポリシーを作成します。
以下の構文セクションのパラメーター セットの詳細については、「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 アプリではなく、Azure Information Protection統合ラベル付けクライアントでのみサポートされます。 手順については、「Azure 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"}
。DisableMandatoryInOutlook: この設定をサポートする Outlook アプリは、Outlook メッセージを必須のラベル付けから除外します。 例:
New-LabelPolicy -Identity Global -AdvancedSettings @{DisableMandatoryInOutlook="True"}
。 この構成の選択の詳細については、「 既定のラベル付けと必須ラベル付けの Outlook 固有のオプション」を参照してください。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 の既定のラベル ポリシー」を参照してください。
Type: | PswsHashtable |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-Comment
Comment パラメーターで、オプションのコメントを指定します。 スペースを含む値を指定する場合は、次のように値を二重引用符 (") で囲んでください。"これは管理者メモです。"
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-Confirm
Confirm スイッチは、確認プロンプトを表示するか非表示にするかを指定します。 このスイッチがコマンドレットにどのような影響を与えるかは、先に進む前にコマンドレットで確認が必要となるかどうかで決まります。
- 破壊的なコマンドレット (Remove-* コマンドレットなど) には、続行する前にコマンドの確認を強制する組み込みの一時停止があります。 これらのコマンドレットでは、正確な構文
-Confirm:$false
を使用して、確認プロンプトを省略できます。 - 他のほとんどのコマンドレット (New-* コマンドレットや Set-* コマンドレットなど) には、一時停止が組み込まれています。 これらのコマンドレットの場合、値なしで Confirm スイッチを指定すると、先に進む前に、一時停止してコマンドを確認する必要があります。
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-ExchangeLocation
ExchangeLocation パラメーターは、ポリシーに含めるメールボックスを指定します。 有効な値はメールボックスです。
メールボックスを指定するには、メールボックスを一意に識別する任意の値を使用できます。 例:
- 名前
- 名前
- 識別名 (DN)
- GUID
Update 値にスペースが含まれている場合、または引用符が必要な場合は、次の構文を使用します。 "Value1","Value2",..."ValueN"
Type: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-ExchangeLocationException
ExchangeLocationException パラメーターは、ExchangeLocation パラメーターの値 All を使用するときに除外するメールボックスを指定します。 有効な値はメールボックスです。
メールボックスを指定するには、メールボックスを一意に識別する任意の値を使用できます。 例:
- 名前
- 名前
- 識別名 (DN)
- GUID
Update 値にスペースが含まれている場合、または引用符が必要な場合は、次の構文を使用します。 "Value1","Value2",..."ValueN"
Type: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-Force
[強制] スイッチは、警告メッセージまたは確認メッセージを非表示にします。 このスイッチで値を指定する必要はありません。
管理者の入力を求めることが不適切な場合に、このスイッチを使用してタスクをプログラムによって実行することができます。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-Labels
Labels パラメーターは、ポリシーに関連付けられている秘密度ラベルを指定します。 ラベルを一意に識別する任意の値を使用できます。 例:
- 名前
- 識別名 (DN)
- GUID
Update 値にスペースが含まれている場合、または引用符が必要な場合は、次の構文を使用します。 "Value1","Value2",..."ValueN"
Type: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-MigrationId
このパラメーターは、Microsoft の内部使用のために予約されています。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-ModernGroupLocation
ModernGroupLocation パラメーターは、ポリシーに含めるMicrosoft 365 グループを指定します。 Microsoft 365 グループを識別するには、プライマリ SMTP アドレスを使用する必要があります。
Update 値にスペースが含まれている場合、または引用符が必要な場合は、次の構文を使用します。 "Value1","Value2",..."ValueN"
Type: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-ModernGroupLocationException
このパラメーターは、Microsoft の内部使用のために予約されています。
Type: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-Name
Name パラメーターは、ポリシーの一意の名前を指定します。 最大の長さは 64 文字です。 値にスペースが含まれている場合は、値を二重引用符 (") で囲んでください。
Type: | String |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-OneDriveLocation
このパラメーターは、Microsoft の内部使用のために予約されています。
Type: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-OneDriveLocationException
このパラメーターは、Microsoft の内部使用のために予約されています。
Type: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-PolicyRBACScopes
{{ Fill PolicyRBACScopes Description }}
Type: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-PublicFolderLocation
このパラメーターは、Microsoft の内部使用のために予約されています。
Type: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-Setting
このパラメーターは、Microsoft の内部使用のために予約されています。
Type: | PswsHashtable |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-Settings
このパラメーターは、Microsoft の内部使用のために予約されています。
Type: | PswsHashtable |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-SharePointLocation
このパラメーターは、Microsoft の内部使用のために予約されています。
Type: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-SharePointLocationException
このパラメーターは、Microsoft の内部使用のために予約されています。
Type: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-SkypeLocation
このパラメーターは、Microsoft の内部使用のために予約されています。
Type: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-SkypeLocationException
このパラメーターは、Microsoft の内部使用のために予約されています。
Type: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-WhatIf
WhatIf スイッチは、セキュリティ & コンプライアンス PowerShell では機能しません。
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |