New-ServicePrincipal
Questo cmdlet è disponibile solamente nel servizio basato sul cloud.
Usare il cmdlet New-ServicePrincipal per creare entità servizio nell'organizzazione basata sul cloud.
Per informazioni sui set di parametri nella sezione Sintassi, vedere Sintassi del cmdlet di Exchange.
Sintassi
Default (Impostazione predefinita)
New-ServicePrincipal
-AppId <String>
-ObjectId <String>
-ServiceId <String>
[-Confirm]
[-DisplayName <String>]
[-Organization <OrganizationIdParameter>]
[-WhatIf]
[<CommonParameters>]
Descrizione
Le entità servizio sono presenti in Microsoft Entra ID per definire cosa possono fare le app, chi può accedere alle app e a quali risorse possono accedere le app. In Exchange Online, le entità servizio sono riferimenti alle entità servizio in Microsoft Entra ID. Per assegnare ruoli di controllo degli accessi in base ai ruoli di Exchange Online alle entità servizio in Microsoft Entra ID, si usano i riferimenti alle entità servizio in Exchange Online. I cmdlet *-ServicePrincipal in PowerShell per Exchange Online consentono di visualizzare, creare e rimuovere questi riferimenti all'entità servizio.
Per altre informazioni, vedere Oggetti entità applicazione e servizio in Microsoft Entra ID.
È necessario disporre delle autorizzazioni prima di poter eseguire questo cmdlet. Anche se questo articolo elenca tutti i parametri per il cmdlet, si potrebbe non avere accesso ad alcuni parametri se non sono inclusi nelle autorizzazioni assegnate. Per individuare le autorizzazioni necessarie per eseguire cmdlet o parametri nell'organizzazione, vedere Trovare le autorizzazioni necessarie per eseguire i cmdlet di Exchange.
Esempio
Esempio 1
New-ServicePrincipal -AppId 71487acd-ec93-476d-bd0e-6c8b31831053 -ObjectId 6233fba6-0198-4277-892f-9275bf728bcc
In questo esempio viene creata una nuova entità servizio in Exchange Online con i valori AppId e ObjectId specificati.
Parametri
-AppId
Applicabile: Exchange Online, sicurezza & conformità, componente aggiuntivo di sicurezza predefinito per le cassette postali locali
Il parametro AppId specifica il valore univoco del GUID AppId per l'entità servizio. Ad esempio, ca73fffa-cedb-4b84-860f-d7fb8aa8a6c1.
Un valore valido per questo parametro è disponibile nelle posizioni seguenti:
- La proprietà AppId nell'output del cmdlet Get-MgServicePrincipal in Microsoft Graph PowerShell.
- La proprietà ID applicazione dalle applicazioni Enterprise nell'interfaccia di amministrazione di Microsoft Entra: https://portal.azure.com/#view/Microsoft_AAD_IAM/StartboardApplicationsMenuBlade/~/AppAppsPreview/menuId~/null.
Proprietà dei parametri
| Tipo: | String |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | True |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Confirm
Applicabile: Exchange Online, sicurezza & conformità, componente aggiuntivo di sicurezza predefinito per le cassette postali locali
L'opzione Confirm consente di specificare se visualizzare o nascondere la richiesta di conferma. Il modo in cui questa opzione influisce sul cmdlet varia se il cmdlet richiede o meno una conferma prima di procedere.
- I cmdlet distruttivi (ad esempio, i cmdlet Remove-*) dispongono di una pausa incorporata che impone all'utente di confermare il comando prima di procedere. Per questi cmdlet, è possibile ignorare la richiesta di conferma usando questa precisa sintassi:
-Confirm:$false. - La maggior parte degli altri cmdlet (ad esempio, i cmdlet New-* e Set-*) non dispone di una pausa incorporata. Per questi cmdlet, se si specifica l'opzione Confirm senza un valore, viene introdotta una pausa che impone di confermare il comando prima di procedere.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
| Alias: | cfr |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-DisplayName
Applicabile: Exchange Online, sicurezza & conformità, componente aggiuntivo di sicurezza predefinito per le cassette postali locali
Il parametro DisplayName consente di specificare il nome descrittivo dell'entità servizio. Se il nome contiene spazi, racchiudere il nome tra virgolette (").
Proprietà dei parametri
| Tipo: | String |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-ObjectId
Applicabile: Exchange Online, sicurezza & conformità, componente aggiuntivo di sicurezza predefinito per le cassette postali locali
Il parametro ObjectId specifica il valore univoco del GUID ObjectId per l'entità servizio. Ad esempio, 7c7599b2-23af-45e3-99ff-0025d148e929.
Un valore valido per questo parametro è disponibile nelle posizioni seguenti:
- La proprietà Id nell'output del cmdlet Get-MgServicePrincipal in Microsoft Graph PowerShell.
- La proprietà ID oggetto dalle applicazioni Enterprise nell'interfaccia di amministrazione di Microsoft Entra: https://portal.azure.com/#view/Microsoft_AAD_IAM/StartboardApplicationsMenuBlade/~/AppAppsPreview/menuId~/null.
Proprietà dei parametri
| Tipo: | String |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | True |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Organization
Applicabile: Sicurezza & conformità
Questo parametro è riservato all'uso interno da parte di Microsoft.
Proprietà dei parametri
| Tipo: | OrganizationIdParameter |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-ServiceId
Applicabile: Exchange Online, sicurezza & conformità, componente aggiuntivo di sicurezza predefinito per le cassette postali locali
Questo parametro è in fase di deprecazione. Usare invece il parametro ObjectId.
Proprietà dei parametri
| Tipo: | String |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | True |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-WhatIf
Il parametro WhatIf non funziona in PowerShell per sicurezza e conformità.
L'opzione WhatIf mostra le operazioni eseguite dal comando senza apportare modifiche. Con questa opzione non è necessario specificare alcun valore.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
| Alias: | wi |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
CommonParameters
Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedere about_CommonParameters.