Update-AzureRmADServicePrincipal

Referentie

Module:: AzureRM.Resources

Hiermee wordt een bestaande Microsoft Entra-service-principal bijgewerkt.

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

Update-AzureRmADServicePrincipal
      -ObjectId <Guid>
      [-DisplayName <String>]
      [-Homepage <String>]
      [-IdentifierUri <String[]>]
      [-KeyCredential <KeyCredential[]>]
      [-PasswordCredential <PasswordCredential[]>]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Update-AzureRmADServicePrincipal
      -ApplicationId <Guid>
      [-Homepage <String>]
      [-IdentifierUri <String[]>]
      [-KeyCredential <KeyCredential[]>]
      [-PasswordCredential <PasswordCredential[]>]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Update-AzureRmADServicePrincipal
      -ServicePrincipalName <String>
      [-DisplayName <String>]
      [-Homepage <String>]
      [-IdentifierUri <String[]>]
      [-KeyCredential <KeyCredential[]>]
      [-PasswordCredential <PasswordCredential[]>]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Update-AzureRmADServicePrincipal
      -InputObject <PSADServicePrincipal>
      [-DisplayName <String>]
      [-Homepage <String>]
      [-IdentifierUri <String[]>]
      [-KeyCredential <KeyCredential[]>]
      [-PasswordCredential <PasswordCredential[]>]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

Hiermee wordt een bestaande Microsoft Entra-service-principal bijgewerkt. Als u de referenties wilt bijwerken die zijn gekoppeld aan deze service-principal, gebruikt u de cmdlet New-AzureRmADSpCredential. Als u de eigenschappen wilt bijwerken die zijn gekoppeld aan de onderliggende toepassing, gebruikt u de cmdlet Update-AzureRmADApplication.

Voorbeelden

Voorbeeld 1: de weergavenaam van een service-principal bijwerken

PS C:\> Update-AzureRmADServicePrincipal -ObjectId 784136ca-3ae2-4fdd-a388-89d793e7c780 -DisplayName MyNewDisplayName

Hiermee wordt de weergavenaam van de service-principal bijgewerkt met object-id '784136ca-3ae2-4fdd-a388-89d793e7c780' als 'MyNewDisplayName'.

Voorbeeld 2: de weergavenaam van een service-principal bijwerken met behulp van piping

PS C:\> Get-AzureRmADServicePrincipal -ObjectId 784136ca-3ae2-4fdd-a388-89d793e7c780 | Update-AzureRmADServicePrincipal -DisplayName MyNewDisplayName

Haalt de service-principal op met object-id '784136ca-3ae2-4fdd-a388-89d793e7c780' en pijpt deze naar de cmdlet Update-AzureRmADServicePrincipal om de weergavenaam van de service-principal bij te werken naar 'MyNewDisplayName'.

Parameters

-ApplicationId

De toepassings-id van de service-principal die moet worden bijgewerkt.

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

-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, accounts, tenants en abonnementen die worden 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 voor de service-principal.

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

-Homepage

De startpagina voor de service-principal.

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

-IdentifierUri

De id-URI('s) voor de service-principal.

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

-InputObject

Het object dat de service-principal vertegenwoordigt die moet worden bijgewerkt.

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

-KeyCredential

De sleutelreferenties voor de service-principal.

Type:	KeyCredential[]
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-ObjectId

De object-id van de service-principal die moet worden bijgewerkt.

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

-PasswordCredential

De wachtwoordreferenties voor de service-principal.

Type:	PasswordCredential[]
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-ServicePrincipalName

De SPN van de service-principal die moet worden bijgewerkt.

Type:	String
Aliassen:	SPN
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: InputObject (ByValue)

Uitvoerwaarden