Set-AzureADMSServicePrincipal

サービス プリンシパルを更新します。

構文

Set-AzureADMSServicePrincipal
   -Id <String>
   [-AccountEnabled <String>]
   [-AppId <String>]
   [-AppRoleAssignmentRequired <Boolean>]
   [-CustomSecurityAttributes <Object>]
   [-DisplayName <String>]
   [-ErrorUrl <String>]
   [-LogoutUrl <String>]
   [-Homepage <String>]
   [-SamlMetadataUrl <String>]
   [-MicrosoftFirstParty <Boolean>]
   [-PublisherName <String>]
   [-PreferredTokenSigningKeyThumbprint <String>]
   [-ReplyUrls <System.Collections.Generic.List`1[System.String]>]
   [-ServicePrincipalNames <System.Collections.Generic.List`1[System.String]>]
   [-Tags <System.Collections.Generic.List`1[System.String]>]
   [-KeyCredentials <System.Collections.Generic.List`1[Microsoft.Open.MSGraph.Model.MsKeyCredential]>]
   [-PasswordCredentials <System.Collections.Generic.List`1[Microsoft.Open.MSGraph.Model.MsPasswordCredential]>]
   [<CommonParameters>]

説明

Azure Active Directory (Azure AD) のサービス プリンシパルを更新します。

例 1

PS C:\> Set-AzureADMSServicePrincipal -Id 2e0d8ca7-57d1-4a87-9c2a-b3638a4cadbf -AccountEnabled $False

このコマンドは、指定されたサービス プリンシパルのアカウントを無効にします。

例 2

PS C:\> $attributes = @{
    Engineering = @{
        "@odata.type" = "#Microsoft.DirectoryServices.CustomSecurityAttributeValue"
        "Project@odata.type" = "#Collection(String)"
        Project = @("Baker","Cascade")
    }
}
PS C:\> Set-AzureADMSServicePrincipal -Id 7d194b0c-bf17-40ff-9f7f-4b671de8dc20 -CustomSecurityAttributes $attributes

複数文字列値を持つカスタム セキュリティ属性をアプリケーション (サービス プリンシパル) に割り当てます。

  • 属性セット: Engineering
  • 属性: Project
  • 属性のデータ型: 文字列のコレクション
  • 属性値: ("Baker","Cascade")

例 3

PS C:\> $attributesUpdate = @{
    Engineering = @{
        "@odata.type" = "#Microsoft.DirectoryServices.CustomSecurityAttributeValue"
        "Project@odata.type" = "#Collection(String)"
        Project = @("Alpine","Baker")
    }
}
PS C:\> Set-AzureADMSServicePrincipal -Id 7d194b0c-bf17-40ff-9f7f-4b671de8dc20 -CustomSecurityAttributes $attributesUpdate

アプリケーション (サービス プリンシパル) の複数文字列値を使用してカスタム セキュリティ属性を更新します。

  • 属性セット: Engineering
  • 属性: Project
  • 属性のデータ型: 文字列のコレクション
  • 属性値: ("Alpine","Baker")

パラメーター

-AccountEnabled

アカウントが有効かどうかを示します。

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-AppId

アプリケーション ID を指定します。

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-AppRoleAssignmentRequired

アプリケーション ロールの割り当てが必要かどうかを示します。

型:Boolean
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-CustomSecurityAttributes

サービス プリンシパルのカスタム セキュリティ属性。

型:Object
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-DisplayName

表示名を指定します。

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ErrorUrl

エラー URL を指定します。

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Homepage

ホーム ページを指定します。

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Id

Azure AD のサービス プリンシパルの ID を指定します。

型:String
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-KeyCredentials

キーの資格情報を指定します。

型:List<T>[Microsoft.Open.MSGraph.Model.MsKeyCredential]
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-LogoutUrl

ログアウト URL を指定します。

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-MicrosoftFirstParty

サービス プリンシパルが Microsoft ファースト パーティ アプリ用かどうかを示します。

型:Boolean
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-PasswordCredentials

パスワード資格情報を指定します。

型:List<T>[Microsoft.Open.MSGraph.Model.MsPasswordCredential]
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-PreferredTokenSigningKeyThumbprint

サービス プリンシパルに推奨されるトークン署名キーの拇印。

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-PublisherName

パブリッシャーの名前を指定します。

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ReplyUrls

関連付けられているアプリケーションにサインインするためにユーザー トークンが送信される URL、または関連付けられているアプリケーションの OAuth 2.0 認証コードとアクセス トークンが送信されるリダイレクト URI。

型:List<T>[String]
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-SamlMetadataUrl

@{Text=}

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ServicePrincipalNames

サービス プリンシパル名を指定します。

型:List<T>[String]
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Tags

タグの配列を指定します。 このサービス プリンシパルを管理ポータルの [すべてのアプリケーション] リストに表示する場合は、この値を {WindowsAzureActiveDirectoryIntegratedApp} に設定する必要があることに注意してください。

型:List<T>[String]
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

入力

String

出力

Object