Remove-MsolServicePrincipalCredential

  • Referenz
Modul:
MSOnline

Entfernt einen Anmeldeschlüssel aus einem Dienstprinzipal.

Syntax

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

Beschreibung

Das Cmdlet Remove-MsolServicePrincipalCredential entfernt einen Anmeldeschlüssel aus einem Dienstprinzipal im Falle eines Kompromittierungs oder im Rahmen des Ablaufs von Anmeldeschlüsseln. Der Dienstprinzipal wird durch Angeben der Objekt-ID, der Anwendungs-ID oder des Dienstprinzipalnamens (SPN) identifiziert. Die zu entfernenden Anmeldeinformationen werden anhand ihrer Schlüssel-ID identifiziert.

Beispiele

Beispiel 1: Entfernen einer Anmeldeinformationen aus einem Dienstprinzipal

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

Dieser Befehl entfernt einen Anmeldeschlüssel aus einem Dienstprinzipal. In diesem Beispiel wird die Schlüssel-ID 19805a93-e9dd-4c63-8afd-88ed91f33546 aus dem Dienstprinzipal entfernt, das dem Dienstprinzipalnamen MyApp2/myApp.com zugeordnet ist. Um eine Liste der Schlüssel-IDs anzuzeigen, die einem Dienstprinzipal zugeordnet sind, verwenden Sie das Cmdlet "Get-MsolServicePrincipalCredential ".

Parameter

-AppPrincipalId

Gibt die Anwendungs-ID des Dienstprinzipals an, aus dem die Anmeldeinformationen entfernt werden sollen.

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

-KeyIds

Gibt ein Array mit eindeutigen IDs von Anmeldeschlüsseln an, die entfernt werden sollen. Die Schlüssel-IDs für einen Dienstprinzipal können mithilfe des Cmdlets "Get-MsolServicePrincipalCredential " abgerufen werden.

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

-ObjectId

Gibt die eindeutige Objekt-ID des Dienstprinzipals an, aus dem die Anmeldeinformationen entfernt werden sollen.

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

-ServicePrincipalName

Gibt den Namen des Dienstprinzipals an, aus dem die Anmeldeinformationen entfernt werden sollen. Ein SPN muss ein der folgenden Formate verwenden:

  • appName
  • appName/hostname
  • eine gültige URL

AppName stellt den Namen der Anwendung dar. Hostname stellt die URI-Autorität für die Anwendung dar.

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

-TenantId

Gibt die eindeutige ID des Mandanten an, auf der der Vorgang ausgeführt werden soll. Der Standardwert ist der Mandanten des aktuellen Benutzers. Dieser Parameter gilt nur für Partnerbenutzer.

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