Condividi tramite

Remove-MsolServicePrincipalCredential

  • Riferimento
Modulo:
MSOnline

Rimuove una chiave delle credenziali da un'entità servizio.

Sintassi

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>]

Descrizione

Il cmdlet remove-MsolServicePrincipalCredential rimuove una chiave delle credenziali da un'entità servizio in caso di compromissione o come parte della scadenza del rollover della chiave delle credenziali. L'entità servizio viene identificata specificando l'ID oggetto, l'ID applicazione o il nome dell'entità servizio (SPN). La credenziale da rimuovere è identificata dal relativo ID chiave.

Esempio

Esempio 1: Rimuovere credenziali da un'entità servizio

PS C:\> Remove-MsolServicePrincipalCredential -KeyIds @("aaaaaaaa-0b0b-1c1c-2d2d-333333333333") -ServicePrincipalName "MyApp2/myApp.com"

Questo comando rimuove una chiave delle credenziali da un'entità servizio. In questo esempio, l'ID chiave aaaaaa-0b0b-1c1c-2d2d-3333333333333 viene rimosso dall'entità servizio associata al nome dell'entità servizio MyApp2/myApp.com. Per visualizzare un elenco di ID chiave associati a un'entità servizio, usare il cmdlet Get-MsolServicePrincipalCredential.

Parametri

-AppPrincipalId

Specifica l'ID applicazione dell'entità servizio da cui rimuovere le credenziali.

Tipo:Guid
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-KeyIds

Specifica una matrice di ID univoci di chiavi delle credenziali da rimuovere. Gli ID chiave per un'entità servizio possono essere ottenuti usando il cmdlet Get-MsolServicePrincipalCredential.

Tipo:Guid[]
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-ObjectId

Specifica l'ID oggetto univoco dell'entità servizio da cui rimuovere le credenziali.

Tipo:Guid
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-ServicePrincipalName

Specifica il nome dell'entità servizio da cui rimuovere le credenziali. Un nome SPN deve usare uno dei formati seguenti:

  • appName
  • appName/hostname
  • UN URL valido

AppName rappresenta il nome dell'applicazione. Hostname rappresenta l'autorità URI per l'applicazione.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-TenantId

Specifica l'ID univoco del tenant in cui eseguire l'operazione. Il valore predefinito è il tenant dell'utente corrente. Questo parametro si applica solo agli utenti partner.

Tipo:Guid
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False