Update-AzureRmADServicePrincipal
既存の Microsoft Entra サービス プリンシパルを更新します。
警告
AzureRM PowerShell モジュールは、2024 年 2 月 29 日に正式に非推奨になりました。 引き続きサポートを受け、更新を受け取れるようにするために、AzureRM から Az PowerShell モジュールに移行することをお勧めします。
AzureRM モジュールの機能は今後も使用できますが、メンテナンスやサポートは行われないため、引き続きの使用はユーザーの判断に委ねられ、リスクが発生することがあります。 Az モジュールへの移行に関するガイダンスについては、移行リソースを参照してください。
構文
Update-AzureRmADServicePrincipal
-ObjectId <Guid>
[-DisplayName <String>]
[-Homepage <String>]
[-IdentifierUri <String[]>]
[-KeyCredential <KeyCredential[]>]
[-PasswordCredential <PasswordCredential[]>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Update-AzureRmADServicePrincipal
-ApplicationId <Guid>
[-Homepage <String>]
[-IdentifierUri <String[]>]
[-KeyCredential <KeyCredential[]>]
[-PasswordCredential <PasswordCredential[]>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Update-AzureRmADServicePrincipal
-ServicePrincipalName <String>
[-DisplayName <String>]
[-Homepage <String>]
[-IdentifierUri <String[]>]
[-KeyCredential <KeyCredential[]>]
[-PasswordCredential <PasswordCredential[]>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Update-AzureRmADServicePrincipal
-InputObject <PSADServicePrincipal>
[-DisplayName <String>]
[-Homepage <String>]
[-IdentifierUri <String[]>]
[-KeyCredential <KeyCredential[]>]
[-PasswordCredential <PasswordCredential[]>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] 説明
既存の Microsoft Entra サービス プリンシパルを更新します。 このサービス プリンシパルに関連付けられている資格情報を更新するには、New-AzureRmADSpCredential コマンドレットを使用してください。 基になるアプリケーションに関連付けられているプロパティを更新するには、Update-AzureRmADApplication コマンドレットを使用してください。
例
例 1 - サービス プリンシパルの表示名を更新する
PS C:\> Update-AzureRmADServicePrincipal -ObjectId 784136ca-3ae2-4fdd-a388-89d793e7c780 -DisplayName MyNewDisplayNameオブジェクト ID '784136ca-3ae2-4fdd-a388-89d793e7c780' のサービス プリンシパルの表示名を 'MyNewDisplayName' に更新します。
例 2 - 配管を使用してサービス プリンシパルの表示名を更新する
PS C:\> Get-AzureRmADServicePrincipal -ObjectId 784136ca-3ae2-4fdd-a388-89d793e7c780 | Update-AzureRmADServicePrincipal -DisplayName MyNewDisplayNameオブジェクト ID '784136ca-3ae2-4fdd-a388-89d793e7c780' を持つサービス プリンシパルを取得し、サービス プリンシパルの表示名を "MyNewDisplayName" に更新するために Update-AzureRmADServicePrincipal コマンドレットにパイプします。
パラメーター
-ApplicationId
更新するサービス プリンシパルのアプリケーション ID。
| 型: | Guid |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-Confirm
コマンドレットの実行前に確認を求めるメッセージが表示されます。
| 型: | SwitchParameter |
| Aliases: | cf |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-DefaultProfile
Azure との通信のために使用される資格情報、アカウント、テナント、サブスクリプションです。
| 型: | IAzureContextContainer |
| Aliases: | AzureRmContext, AzureCredential |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-DisplayName
サービス プリンシパルの表示名。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-Homepage
サービス プリンシパルのホームページ。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-IdentifierUri
サービス プリンシパルの識別子 URI。
| 型: | String[] |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-InputObject
更新するサービス プリンシパルを表すオブジェクト。
| 型: | PSADServicePrincipal |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-KeyCredential
サービス プリンシパルのキー資格情報。
| 型: | KeyCredential[] |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-ObjectId
更新するサービス プリンシパルのオブジェクト ID。
| 型: | Guid |
| Aliases: | ServicePrincipalObjectId |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-PasswordCredential
サービス プリンシパルのパスワード資格情報。
| 型: | PasswordCredential[] |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-ServicePrincipalName
更新するサービス プリンシパルの SPN。
| 型: | String |
| Aliases: | SPN |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-WhatIf
コマンドレットの実行時に発生する内容を示します。 このコマンドレットは実行されません。
| 型: | SwitchParameter |
| Aliases: | wi |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
入力
Parameters: InputObject (ByValue)