New-ComplianceTag

構文

Default

New-ComplianceTag
    [-Name] <String>
    [-AutoApprovalPeriod <System.Int32>]
    [-Comment <String>]
    [-ComplianceTagForNextStage <String>]
    [-Confirm]
    [-EventType <ComplianceRuleIdParameter>]
    [-FilePlanProperty <String>]
    [-FlowId <System.Guid>]
    [-Force]
    [-IsRecordLabel <Boolean>]
    [-IsRecordUnlockedAsDefault <Boolean>]
    [-MultiStageReviewProperty <String>]
    [-Notes <String>]
    [-Regulatory <Boolean>]
    [-RetentionAction <String>]
    [-RetentionDuration <Unlimited>]
    [-RetentionType <String>]
    [-ReviewerEmail <SmtpAddress[]>]
    [-WhatIf]
    [<CommonParameters>]

PriorityCleanup

New-ComplianceTag
    [-Name] <String>
    -RetentionAction <String>
    -RetentionDuration <Unlimited>
    -RetentionType <String>
    -MultiStageReviewProperty <String>
    [-PriorityCleanup]
    [-Comment <String>]
    [-Confirm]
    [-Force]
    [-Notes <String>]
    [-WhatIf]
    [<CommonParameters>]

説明

例

例 1

New-ComplianceTag -Name "HR Content" -RetentionAction Keep -RetentionDuration 1825 -RetentionType ModificationAgeInDays

パラメーター

-AutoApprovalPeriod

適用対象: セキュリティ & コンプライアンス

{{ Fill AutoApprovalPeriod Description }}

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

パラメーター セット

-Comment

適用対象: セキュリティ & コンプライアンス

Comment パラメーターで、オプションのコメントを指定します。 スペースを含む値を指定する場合は、次のように値を二重引用符 (") で囲んでください。"これは管理者メモです。"

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

パラメーター セット

-ComplianceTagForNextStage

適用対象: セキュリティ & コンプライアンス

{{ Fill ComplianceTagForNextStage Description }}

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

パラメーター セット

-Confirm

適用対象: セキュリティ & コンプライアンス

Confirm スイッチは、確認プロンプトを表示するか非表示にするかを指定します。 このスイッチがコマンドレットにどのような影響を与えるかは、先に進む前にコマンドレットで確認が必要となるかどうかで決まります。

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

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

パラメーター セット

-EventType

適用対象: セキュリティ & コンプライアンス

EventType は、ラベルに関連付けられている保持ルールを指定します。 ルールを一意に識別する任意の値を使用できます。 次に例を示します。

• 名前
• 識別名 (DN)
• GUID

使用可能な保持規則を確認するには、Get-RetentionComplianceRule コマンドレットを使用します。

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

パラメーター セット

-FilePlanProperty

適用対象: セキュリティ & コンプライアンス

FilePlanProperty パラメーターは、ラベルに含めるファイル プランのプロパティを指定します。 このパラメーターで使用する必要があるファイル プラン のプロパティ名を表示するには、次のコマンドを実行します。

• Get-FilePlanPropertyAuthority | Format-List Name
• Get-FilePlanPropertyCategory | Format-List Name
• Get-FilePlanPropertyCitation | Format-List Name
• Get-FilePlanPropertyDepartment | Format-List Name
• Get-FilePlanPropertyReferenceId | Format-List Name
• Get-FilePlanPropertySubCategory | Format-List Name

このパラメーターの有効な値には、次の 2 つの手順が含まれます。

• 次の構文を使用して、ファイル プランのプロパティを PSCustomObject として格納する変数。

  $Variable1=[PSCustomObject]@{Settings=@(@{Key="FilePlanPropertyDepartment";Value="Name"},@{Key="FilePlanPropertyCategory";Value="Name"},@{Key="FilePlanPropertySubcategory";Value="Name"},@{Key="FilePlanPropertyCitation";Value="Name"},@{Key="FilePlanPropertyReferenceId";Value="Name"},@{Key="FilePlanPropertyAuthority";Value="Name"})}

  例:

  $retentionLabelAction=[PSCustomObject]@{Settings=@(@{Key="FilePlanPropertyDepartment";Value="Legal"},@{Key="FilePlanPropertyCategory";Value="Tax"},@{Key="FilePlanPropertySubcategory";Value="US_Tax"},@{Key="FilePlanPropertyCitation";Value="LegalCitation"},@{Key="FilePlanPropertyReferenceId";Value="ReferenceA"},@{Key="FilePlanPropertyAuthority";Value="Auth1"})}

• 次の構文を使用して PSCustomObject を JSON オブジェクトに変換する 2 番目の変数。

  $Variable2 = ConvertTo-Json $Variable1

  例:

  $fpStr = ConvertTo-Json $retentionLabelAction

このパラメーターの値として 2 番目の変数を使用します。

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

パラメーター セット

-FlowId

適用対象: セキュリティ & コンプライアンス

注: このパラメーターは現在プレビュー段階であり、すべての組織で使用できるわけではありません。変更される可能性があります。

FlowId パラメーターは、保持期間の終了時に実行する Power Automate フローを指定します。 このパラメーターの有効な値は、フローの GUID 値です。

フローの GUID 値は、次のいずれかの方法を使用して確認できます。

• Power Automate ポータルからフローに移動します。 フローの GUID 値は URL にあります。
• "管理者としてフローを一覧表示する" という名前の Power Automate アクションを使用します。

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

パラメーター セット

-Force

適用対象: セキュリティ & コンプライアンス

[強制] スイッチは、警告メッセージまたは確認メッセージを非表示にします。 このスイッチで値を指定する必要はありません。

管理者の入力を求めることが不適切な場合に、このスイッチを使用してタスクをプログラムによって実行することができます。

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

パラメーター セット

-IsRecordLabel

適用対象: セキュリティ & コンプライアンス

IsRecordLabel パラメーターは、ラベルがレコード ラベルであるかどうかを指定します。 有効な値は次のとおりです。

• $true: ラベルはレコード ラベルです。 ラベルがコンテンツに適用されると、ラベルを削除することはできません。
• $false: ラベルはレコード ラベルではありません。 この値が既定値です。

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

パラメーター セット

-IsRecordUnlockedAsDefault

適用対象: セキュリティ & コンプライアンス

{{ Fill IsRecordUnlockedAsDefault Description }}

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

パラメーター セット

-MultiStageReviewProperty

適用対象: セキュリティ & コンプライアンス

MultiStageReviewProperty パラメーターは、ラベルに含めるマルチステージ レビュー プロパティを指定します。 このパラメーターには、次の構文を使用します。

'{"MultiStageReviewSettings":[{"StageName":"Stage1","Reviewers":[reviewer1,reviewer2,...reviewerN]},{"StageName":"Stage2","Reviewers":[reviewer1,reviewer2,...reviewerN]},]}'

例:

'{"MultiStageReviewSettings":[{"StageName":"Stage1","Reviewers":[jie@contoso.onmicrosoft.com]},{"StageName":"Stage2","Reviewers":[bharath@contoso.onmicrosoft.com,helen@contoso.onmicrosoft.com]},]}'

この構文は、各レビュー ステージ ID、レビュー ステージ名、レビュー担当者の一覧を定義する JSON オブジェクトです。

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

パラメーター セット

-Name

適用対象: セキュリティ & コンプライアンス

Name パラメーターは、ラベルの一意の名前を指定します。 値にスペースが含まれている場合は、値を二重引用符 (") で囲んでください。

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

パラメーター セット

-Notes

適用対象: セキュリティ & コンプライアンス

Notes パラメーターは、オブジェクトに関する追加情報を指定します。 値にスペースが含まれている場合は、値を二重引用符 (") で囲んでください。

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

パラメーター セット

-PriorityCleanup

適用対象: セキュリティ & コンプライアンス

{{ Fill PriorityCleanup Description }}

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

パラメーター セット

-Regulatory

適用対象: セキュリティ & コンプライアンス

{{ Fill Regulatory Description }}

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

パラメーター セット

-RetentionAction

適用対象: セキュリティ & コンプライアンス

RetentionAction パラメーターは、ラベルのアクションを指定します。 有効な値は次のとおりです。

• 削除
• 保持
• KeepAndDelete

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

パラメーター セット

-RetentionDuration

適用対象: セキュリティ & コンプライアンス

RetentionDuration パラメーターは、コンテンツを保持する日数を指定します。 有効な値は次のとおりです。

• 正の整数。
• 値 unlimited。

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

パラメーター セット

-RetentionType

適用対象: セキュリティ & コンプライアンス

RetentionType パラメーターは、コンテンツの作成日、タグ付けされた日付、または最終変更日から保持期間を計算するかどうかを指定します。 有効な値は次のとおりです。

• CreationAgeInDays
• EventAgeInDays
• ModificationAgeInDays
• TaggedAgeInDays

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

パラメーター セット

-ReviewerEmail

適用対象: セキュリティ & コンプライアンス

ReviewerEmail パラメーターは、Delete および KeepAndDelete の保存期間用アクションのレビュー担当者の電子メール アドレスを指定します。 複数のメール アドレスをコンマで区切って指定できます。

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

パラメーター セット

-WhatIf

適用対象: セキュリティ & コンプライアンス

WhatIf スイッチは、セキュリティ/コンプライアンス PowerShell では機能しません。

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

パラメーター セット

CommonParameters