Remove-MsolServicePrincipalCredential

サービス プリンシパルから資格情報キーを削除します。

構文

Remove-MsolServicePrincipalCredential
      -ObjectId <Guid>
      -KeyIds <Guid[]>
      [-TenantId <Guid>]
      [<CommonParameters>]
Remove-MsolServicePrincipalCredential
      -KeyIds <Guid[]>
      -ServicePrincipalName <String>
      [-TenantId <Guid>]
      [<CommonParameters>]
Remove-MsolServicePrincipalCredential
      -KeyIds <Guid[]>
      -AppPrincipalId <Guid>
      [-TenantId <Guid>]
      [<CommonParameters>]

説明

Remove-MsolServicePrincipalCredential コマンドレットは、セキュリティ侵害が発生した場合、または資格情報キーのロールオーバーの有効期限の一部として、サービス プリンシパルから資格情報キーを削除します。 サービス プリンシパルを指定するには、オブジェクト ID、アプリケーション ID、またはサービス プリンシパル名 (SPN) を指定します。 削除する資格情報は、キー ID で指定します。

例 1: サービス プリンシパルから資格情報を削除する

PS C:\> Remove-MsolServicePrincipalCredential -KeyIds @("19805a93-e9dd-4c63-8afd-88ed91f33546") -ServicePrincipalName "MyApp2/myApp.com"

このコマンドは、サービス プリンシパルから資格情報キーを削除します。 この例では、キー ID 19805a93-e9dd-4c63-8afd-88ed91f33546 は、サービス プリンシパル名 MyApp2/myApp.com に関連付けられているサービス プリンシパルから削除されます。 サービス プリンシパルに関連付けられているキー ID の一覧を表示するには、 Get-MsolServicePrincipalCredential コマンドレットを使用します。

パラメーター

-AppPrincipalId

資格情報を削除するサービス プリンシパルのアプリケーション ID を指定します。

Type:Guid
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-KeyIds

削除する資格情報キーの一意の ID の配列を指定します。 サービス プリンシパルのキー ID は、 Get-MsolServicePrincipalCredential コマンドレットを使用して取得できます。

Type:Guid[]
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ObjectId

資格情報を削除するサービス プリンシパルの一意のオブジェクト ID を指定します。

Type:Guid
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ServicePrincipalName

資格情報を削除するサービス プリンシパルの名前を指定します。 SPN では、次のいずれかの形式を使用する必要があります。

  • appName
  • appName/hostname
  • 有効な URL

AppName は、アプリケーションの名前を表します。 ホスト名は、アプリケーションの URI 機関を表します。

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-TenantId

操作を実行するテナントの一意の ID を指定します。 既定値は、現在のユーザーのテナントです。 このパラメーターは、パートナー ユーザーにのみ適用されます。

Type:Guid
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False