Set-MsolServicePrincipal

  • Riferimento
Modulo:
MSOnline

Aggiornamenti un'entità servizio in Microsoft Azure Active Directory.

Sintassi

Set-MsolServicePrincipal
   [-ObjectId <Guid>]
   [-AppPrincipalId <Guid>]
   [-DisplayName <String>]
   [-ServicePrincipalNames <String[]>]
   [-AccountEnabled <Boolean>]
   [-Addresses <RedirectUri[]>]
   [-TenantId <Guid>]
   [<CommonParameters>]

Descrizione

Il cmdlet Set-MsolServicePrincipal aggiorna un'entità servizio in Microsoft Azure Active Directory. Può essere utilizzato per aggiornare il nome visualizzato, per abilitare o disabilitare l'entità servizio, trusted per la delega, per i nomi o gli indirizzi dell'entità servizio.

Esempio

Esempio 1: Modificare le proprietà in un'entità servizio

PS C:\> $AppId = (Get-MsolServicePrincipal -ServicePrincipalName "MyApp").AppPrincipalId
PS C:\> Set-MsolServicePrincipal -AppPrincipalId $AppId -DisplayName "My Super Application" -ServicePrincipalNames @("MyApp/myapp.com", "MyApp/mysuperapp.com")

Questo comando aggiorna le proprietà nell'entità servizio specificata. In questo esempio vengono specificati gli aggiornamenti al nome visualizzato e ai nomi SPN. Verranno sovrascritte tutte le impostazioni precedenti.

Esempio 2: Modificare gli indirizzi in un'entità servizio

PS C:\> $a = @()
PS C:\> $a = $a + (Get-MsolServicePrincipal -ServicePrincipalName "MyApp").Addresses
PS C:\> $a = $a + (New-MsolServicePrincipalAddresses -Value "myApp1.com")
PS C:\> $a = $a + (New-MsolServicePrincipalAddresses -Value "myApp2.com")
PS C:\> Set-MsolServicePrincipal -AppPrincipalId $AppId -Addresses $a

Questo comando aggiorna gli indirizzi di un'entità servizio. In questo esempio, gli indirizzi esistenti creati in precedenza ("myApp1.com", "myApp2.com") usando il cmdlet New-MsolServicePrincipalAddresses sono associati all'entità servizio.

Parametri

-AccountEnabled

La proprietà viene riservata per un utilizzo futuro.

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

-Addresses

Specifica l'elenco di indirizzi con cui aggiornare e sovrascrivere l'elenco esistente. Se non si specifica questo parametro, la proprietà esistente non viene aggiornata. Se si specifica un elenco vuoto, gli indirizzi esistenti vengono cancellati. Utilizzare il cmdlet New-MsolServicePrincipalAddress per creare l'oggetto elenco Addresses.

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

-AppPrincipalId

Specifica l'ID applicazione univoco associato all'entità servizio da aggiornare.

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

-DisplayName

Specifica il nome visualizzato dell'entità servizio.

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

-ObjectId

Specifica l'ID oggetto univoco dell'entità servizio da aggiornare.

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

-ServicePrincipalNames

Specifica l'elenco di nomi SPN con cui aggiornare e sovrascrivere l'esistente. Se non si specifica questo parametro, la proprietà esistente non viene aggiornata. Se si specifica un elenco vuoto, i nomi SPN esistenti vengono cancellati, ad eccezione del nome SPN che contiene il valore AppId dell'entità servizio. Un nome SPN deve usare uno dei formati seguenti:

  • appName
  • appName/hostname
  • UN URL valido
Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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.

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