Set-EntraBetaCustomSecurityAttributeDefinition

モジュール:
Microsoft.Entra.Beta.DirectoryManagement Module v1.3

customSecurityAttributeDefinition オブジェクトのプロパティを更新します。

構文

Default (既定) 

Set-EntraBetaCustomSecurityAttributeDefinition

    -Id <String>
    [-Description <String>]
    [-Status <String>]
    [-UsePreDefinedValuesOnly <Boolean>]
    [<CommonParameters>]

説明

customSecurityAttributeDefinition オブジェクトのプロパティを更新します。 カスタム セキュリティ属性定義 Id 更新するパラメーターを指定します。

サインインしているユーザーには、次のいずれかのディレクトリ ロールを割り当てる必要があります。

  • 属性定義管理者

例

例 1: カスタム セキュリティ属性を更新する

Connect-Entra -Scopes 'CustomSecAttributeDefinition.Read.All', 'CustomSecAttributeDefinition.ReadWrite.All'
$attributeDefinition = Get-EntraBetaCustomSecurityAttributeDefinition | Where-Object { $_.Name -eq 'Engineering' }
Set-EntraBetaCustomSecurityAttributeDefinition -Id $attributeDefinition.Id -Description 'Engineering Description' -Status 'Available' -UsePreDefinedValuesOnly $false

この例では、カスタム セキュリティ属性を更新します。

  • -Id パラメーターは、カスタム セキュリティ属性定義オブジェクト ID を指定します。
  • -Description パラメーターは、カスタム セキュリティ属性の説明を指定します。
  • -Status パラメーターは、カスタム セキュリティ属性がアクティブまたは非アクティブであることを指定します。
  • -UsePreDefinedValuesOnly パラメーターは、カスタム セキュリティ属性に割り当てることができる定義済みの値のみを指定します。

パラメーター

-Description

カスタム セキュリティ属性の説明(最大 128 文字、Unicode 文字を含む)。 この説明は後で変更できます。

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

型:System.String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-Id

Microsoft Entra IDカスタム セキュリティ属性定義オブジェクトの一意識別子。

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

型:System.String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:True
パイプラインからの値:True
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

-Status

カスタム セキュリティ属性がアクティブか非アクティブかを指定します。 使用可能な値は、Available と Deprecated です。 後で変更できます。

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

型:System.String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-UsePreDefinedValuesOnly

定義済みの値のみをカスタム セキュリティ属性に割り当てることができるかどうかを示します。 false に設定すると、自由形式の値を使用できます。 後で true から false に変更できますが、false から true に変更することはできません。 型が Boolean に設定されている場合、usePreDefinedValuesOnly を true に設定することはできません。

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

型:System.Boolean
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

CommonParameters

このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。

入力

System.String

出力

System.Object