Delen via

Remove-AzureRmADSpCredential

  • Referentie
Module:
AzureRM.Resources

Hiermee verwijdert u een referentie uit een service-principal.

Waarschuwing

De AzureRM PowerShell-module is vanaf 29 februari 2024 officieel afgeschaft. Gebruikers wordt aangeraden om van AzureRM naar de Az PowerShell-module te migreren om ondersteuning en updates te garanderen.

Hoewel de AzureRM-module nog steeds kan functioneren, wordt deze niet meer onderhouden of ondersteund, waardoor het gebruik naar eigen goeddunken en risico van de gebruiker blijft bestaan. Raadpleeg onze migratiebronnen voor hulp bij de overgang naar de Az-module.

Syntaxis

Remove-AzureRmADSpCredential
      -ObjectId <Guid>
      [-KeyId <Guid>]
      [-PassThru]
      [-Force]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-AzureRmADSpCredential
      -ServicePrincipalName <String>
      [-KeyId <Guid>]
      [-PassThru]
      [-Force]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-AzureRmADSpCredential
      -DisplayName <String>
      [-PassThru]
      [-Force]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-AzureRmADSpCredential
      -ServicePrincipalObject <PSADServicePrincipal>
      [-KeyId <Guid>]
      [-PassThru]
      [-Force]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

De cmdlet Remove-AzureRmADSpCredential kan worden gebruikt om een referentiesleutel uit een service-principal te verwijderen in het geval van een inbreuk of als onderdeel van de verlooptijd van de referentiesleutel. De service-principal wordt geïdentificeerd door de object-id of de SPN (Service Principal Name) op te geven. De referentie die moet worden verwijderd, wordt geïdentificeerd door de sleutel-id als een afzonderlijke referentie moet worden verwijderd of met de schakeloptie Alles om alle referenties te verwijderen die zijn gekoppeld aan de service-principal.

Voorbeelden

Voorbeeld 1: een specifieke referentie uit een service-principal verwijderen

PS C:\> Remove-AzureRmADSpCredential -ObjectId 00001111-aaaa-2222-bbbb-3333cccc4444 -KeyId 9044423a-60a3-45ac-9ab1-09534157ebb

Hiermee verwijdert u de referentie met sleutel-id '9044423a-60a3-45ac-9ab1-09534157ebb' uit de service-principal met object-id '00001111-aaaa-2222-bbbb-3333cccc44444'.

Voorbeeld 2: alle referenties uit een service-principal verwijderen

PS C:\> Remove-AzureRmADSpCredential -ServicePrincipalName http://test123

Hiermee verwijdert u alle referenties uit de service-principal met de SPN 'http://test123".

Voorbeeld 3: verwijder alle referenties uit een service-principal met behulp van piping

PS C:\> Get-AzureRmADServicePrincipal -ObjectId 00001111-aaaa-2222-bbbb-3333cccc4444 | Remove-AzureRmADSpCredential

Haalt de service-principal op met object-id '00001111-aaaa-2222-bbbb-333cccc4444' en pijpen die naar de cmdlet Remove-AzureRmADSpCredential om alle referenties uit die service-principal te verwijderen.

Parameters

-Confirm

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:SwitchParameter
Aliassen:cf
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-DefaultProfile

De referenties, het account, de tenant en het abonnement dat wordt gebruikt voor communicatie met Azure

Type:IAzureContextContainer
Aliassen:AzureRmContext, AzureCredential
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-DisplayName

De weergavenaam van de service-principal.

Type:String
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Force

Schakel over naar het verwijderen van referenties zonder bevestiging.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-KeyId

Hiermee geeft u de referentiesleutel die moet worden verwijderd. De sleutel-id's voor een service-principal kunnen worden verkregen met behulp van de cmdlet Get-AzureRmADSpCredential.

Type:Guid
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-ObjectId

De object-id van de service-principal waaruit de referenties moeten worden verwijderd.

Type:Guid
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-PassThru

Als u dit opgeeft, wordt waar geretourneerd als de opdracht is geslaagd.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ServicePrincipalName

De naam (SPN) van de service-principal waaruit de referenties moeten worden verwijderd.

Type:String
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-ServicePrincipalObject

Het service-principal-object waaruit de referenties moeten worden verwijderd.

Type:PSADServicePrincipal
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-WhatIf

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.

Type:SwitchParameter
Aliassen:wi
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Invoerwaarden

Guid

String

PSADServicePrincipal

Parameters: ServicePrincipalObject (ByValue)

Uitvoerwaarden

Boolean