Set-OrganizationSegment
このコマンドレットは、セキュリティ & コンプライアンス PowerShell でのみ使用できます。 詳細については、「 セキュリティ & コンプライアンス PowerShell」を参照してください。
Set-OrganizationSegment コマンドレットを使用して、Microsoft Purview コンプライアンス ポータル内の組織セグメントを変更します。 組織セグメントは、 情報バリア ポリシーを適用するまで有効になりません。
以下の構文セクションのパラメーター セットの詳細については、「Exchangeのコマンドレット構文」を参照してください。
構文
Set-OrganizationSegment
[-Identity] <PolicyIdParameter>
[-UserGroupFilter <String>]
[<CommonParameters>]
説明
セグメントは、Azure Active Directory の特定 の属性を 使用して定義されます。
セキュリティ & コンプライアンス PowerShell でこのコマンドレットを使用するには、アクセス許可を割り当てる必要があります。 詳細については、「Microsoft Purview コンプライアンス センターのアクセス許可」 を参照してください。
例
例 1
Set-OrganizationSegment -Identity c96e0837-c232-4a8a-841e-ef45787d8fcd -UserGroupFilter "Department -eq 'HRDept'"
この例では、GUID c96e0837-c232-4a8a-841e-ef45787d8fcd を持つセグメントについて、部署名を "HRDept" に更新しました。
パラメーター
-Identity
Identity パラメーターは、変更する組織セグメントを指定します。 セグメントを一意に識別する任意の値を使用できます。 例:
- 名前
- 識別名 (DN)
- GUID
Type: | PolicyIdParameter |
Position: | 0 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-UserGroupFilter
UserGroupFilter パラメーターは、OPATH フィルター構文を使用して、組織セグメントのメンバーを指定します。 構文は ( "Property -ComparisonOperator 'Value'"
や "MemberOf -eq 'Engineering Department'"
"ExtensionAttribute1 -eq 'DayTrader'"
など) です。
- OPATH フィルター全体を二重引用符 " " で囲みます。 フィルターにシステム値 (例えば、
$true
、$false
、または$null
) が含まれている場合は、代わりに単一引用符 ' ' を使用します。 このパラメーターは文字列 (システム ブロックではありません) ですが、波かっこ { } を使用することもできますが、これはフィルターに変数が含まれていない場合のみです。 - Property はフィルタリング可能なプロパティです。 詳細については、「 バリア ポリシーの情報の属性」を参照してください。
- ComparisonOperator は OPATH 比較演算子です (たとえば
-eq
、等しい場合や-like
文字列比較の場合)。 比較演算子の詳細については、「about_Comparison_Operators」を参照してください。 - Value は、検索するプロパティ値です。 テキスト値と変数を一重引用符 (
'Value'
または'$Variable'
) で囲みます。 変数値に一重引用符が含まれている場合、変数を正しく展開するには、一重引用符を識別する (エスケープする) 必要があります。 たとえば、'$User'
の代わりに'$($User -Replace "'","''")'
を使用します。 整数またはシステム値を引用符で囲まないでください (代わりに、500
、$true
、$false
など$null
)。
すべてのセグメントに同じプロパティを使用し、セグメントが重複していないことを確認します (ユーザーは 1 つのセグメントにのみ割り当てる必要があります)。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |