New-ServicePrincipal

  • Riferimento
Modulo:
ExchangePowerShell
Si applica a:
Exchange Online, Security & Compliance, Exchange Online Protection

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

New-ServicePrincipal
   -AppId <String>
   -ServiceId <String>
   [-Confirm]
   [-DisplayName <String>]
   [-WhatIf]
   [<CommonParameters>]

Descrizione

Le entità servizio esistono in Azure Active Directory per definire le operazioni che le app possono eseguire, chi può accedere alle app e quali risorse possono accedere alle app. In Exchange Online le entità servizio sono riferimenti alle entità servizio in Azure AD. Per assegnare Exchange Online ruoli di controllo degli accessi in base al ruolo alle entità servizio in Azure AD, usare i riferimenti all'entità servizio in Exchange Online. I cmdlet *-ServicePrincipal in Exchange Online PowerShell consentono di visualizzare, creare e rimuovere questi riferimenti all'entità servizio.

Per altre informazioni, vedere Oggetti applicazione e entità servizio in Azure Active Directory.

È necessario disporre delle autorizzazioni prima di poter eseguire questo cmdlet. Sebbene in questo argomento vengano elencati tutti i parametri relativi al cmdlet, si potrebbe non avere accesso ad alcuni di essi qualora non siano 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 -ServiceId 6233fba6-0198-4277-892f-9275bf728bcc

In questo esempio viene creata una nuova entità servizio in Exchange Online con i valori AppId e ServiceId specificati.

Parametri

-AppId

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:

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Security & Compliance, Exchange Online Protection

-Confirm

L'opzione Confirm consente di specificare se visualizzare o nascondere la richiesta di conferma. L'impatto di questa opzione sul cmdlet dipende dalla richiesta di conferma del cmdlet prima di procedere.

  • I cmdlet distruttivi , ad esempio i cmdlet Remove-*, hanno una pausa predefinita che impone 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 hanno una pausa predefinita. Per questi cmdlet, specificando l'opzione Confirm senza un valore viene introdotta una pausa che impone all'utente di confermare il comando prima di procedere.
Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Security & Compliance, Exchange Online Protection

-DisplayName

Il parametro DisplayName consente di specificare il nome descrittivo dell'entità servizio. Se il nome contiene spazi, racchiudere il nome tra virgolette (").

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Security & Compliance, Exchange Online Protection

-ServiceId

Il parametro ServiceId specifica il valore guid ServiceId univoco per l'entità servizio. Ad esempio, 7c7599b2-23af-45e3-99ff-0025d148e929.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Security & Compliance, Exchange Online Protection

-WhatIf

L'opzione WhatIf consente di simulare le azioni del comando. È possibile utilizzare tale opzione per visualizzare le modifiche che verrebbero applicate senza effettivamente applicarle. Con questa opzione non è necessario specificare alcun valore.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Security & Compliance, Exchange Online Protection