New-EntraServicePrincipalPasswordCredential

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

サービス プリンシパルのパスワード資格情報を作成します。

構文

Default (既定) 

New-EntraServicePrincipalPasswordCredential

    -ServicePrincipalId <String>
    [-EndDate <DateTime>]
    [-StartDate <DateTime>]
    [-DisplayName <String>]
    [<CommonParameters>]

説明

New-EntraServicePrincipalPasswordCredential コマンドレットは、Microsoft Entra IDでサービス プリンシパルのパスワード資格情報を作成します。

例

例 1: StartDate を使用してパスワード資格情報を作成する

Connect-Entra -Scopes 'Application.ReadWrite.All','Application.ReadWrite.OwnedBy'
$servicePrincipal = Get-EntraServicePrincipal -Filter "displayName eq 'Helpdesk Application'"
New-EntraServicePrincipalPasswordCredential -ServicePrincipalId $servicePrincipal.Id -DisplayName 'Helpdesk App Credential' -StartDate '2024-11-04T14:14:14Z'

secretText          : A1bC2dE3fH4iJ5kL6mN7oP8qR9sT0u
@odata.type         : #microsoft.graph.servicePrincipal
endDateTime         : 08-08-2026 10:30:00
hint                : LY.
customKeyIdentifier :
startDateTime       : 08-08-2024 14:14:14
keyId               : aaaaaaaa-0b0b-1c1c-2d2d-333333333333
@odata.context      : https://graph.microsoft.com/beta/$metadata#servicePrincipals('00001111-aaaa-2222-bbbb-3333cccc4444')/addPassword
displayName         :
StartDate           : 08-08-2024 14:14:14
EndDate             : 08-08-2026 10:30:00

この例では、Microsoft Entra IDのサービス プリンシパルの StartDate を使用してパスワード資格情報を作成する方法を示します。

  • -ServicePrincipalId パラメーターは、サービス プリンシパルの ID を指定します。
  • -DisplayName パラメーターは、パスワードのフレンドリ名を指定します。
  • -StarteDate パラメーターは、パスワードが有効になる日時を指定します。

例 2: EndDate を使用してパスワード資格情報を作成する

Connect-Entra -Scopes 'Application.ReadWrite.All','Application.ReadWrite.OwnedBy'
$servicePrincipal = Get-EntraServicePrincipal -Filter "displayName eq 'Helpdesk Application'"
New-EntraServicePrincipalPasswordCredential -ServicePrincipalId $servicePrincipal.Id -DisplayName 'Helpdesk App Credential' -EndDate '2024-11-04T14:14:14Z'

secretText          : A1bC2dE3fH4iJ5kL6mN7oP8qR9sT0u
@odata.type         : #microsoft.graph.servicePrincipal
endDateTime         : 08-08-2026 10:30:00
hint                : LY.
customKeyIdentifier :
startDateTime       : 08-08-2024 14:14:14
keyId               : bbbbbbbb-1c1c-2d2d-3e3e-444444444444
@odata.context      : https://graph.microsoft.com/beta/$metadata#servicePrincipals('00001111-aaaa-2222-bbbb-3333cccc4444')/addPassword
displayName         :
StartDate           : 08-08-2024 14:14:14
EndDate             : 08-08-2026 10:30:00

この例では、Microsoft Entra IDでサービス プリンシパルの EndDate を使用してパスワード資格情報を作成する方法を示します。

  • -ServicePrincipalId パラメーターは、サービス プリンシパルの ID を指定します。
  • -DisplayName パラメーターは、パスワードのフレンドリ名を指定します。
  • -EndDate パラメーターは、パスワードの有効期限が切れる日時を ISO 8601 形式で表し、常に UTC 時刻で指定します。

パラメーター

-DisplayName

パスワードのフレンドリ名。

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

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

パラメーター セット

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

-EndDate

パスワードの有効期限が切れる日付と時刻は、ISO 8601 形式を使用して表され、常に UTC 時刻になります。 たとえば、2024 年 1 月 1 日午前 0 時 (UTC) は 2024-01-01T00:00:00Z です。

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

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

パラメーター セット

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

-ServicePrincipalId

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

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

型:System.String
規定値:None
ワイルドカードのサポート:False
DontShow:False
Aliases:オブジェクト識別子

パラメーター セット

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

-StartDate

パスワードが有効になる日時。 Timestamp 型は、ISO 8601 形式を使用して日付と時刻の情報を表し、常に UTC 時間です。 たとえば、2024 年 1 月 1 日午前 0 時 (UTC) は 2024-01-01T00:00:00Z です。

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

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

パラメーター セット

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

CommonParameters

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