Bagikan melalui

New-AzureADServicePrincipal

  • Referensi
Modul:
AzureAD

Membuat perwakilan layanan.

Sintaks

New-AzureADServicePrincipal
   [-AccountEnabled <String>]
   [-AlternativeNames <System.Collections.Generic.List`1[System.String]>]
   -AppId <String>
   [-AppRoleAssignmentRequired <Boolean>]
   [-DisplayName <String>]
   [-ErrorUrl <String>]
   [-Homepage <String>]
   [-KeyCredentials <System.Collections.Generic.List`1[Microsoft.Open.AzureAD.Model.KeyCredential]>]
   [-LogoutUrl <String>]
   [-PasswordCredentials <System.Collections.Generic.List`1[Microsoft.Open.AzureAD.Model.PasswordCredential]>]
   [-PublisherName <String>]
   [-ReplyUrls <System.Collections.Generic.List`1[System.String]>]
   [-SamlMetadataUrl <String>]
   [-ServicePrincipalNames <System.Collections.Generic.List`1[System.String]>]
   [-ServicePrincipalType <String>]
   [-Tags <System.Collections.Generic.List`1[System.String]>]
   [<CommonParameters>]

Contoh

Contoh 1: Membuat perwakilan layanan

PS C:\>New-AzureADServicePrincipal -AccountEnabled $true -AppId $MyApp.AppId -AppRoleAssignmentRequired $true -DisplayName $App -Tags {WindowsAzureActiveDirectoryIntegratedApp}

Perintah ini membuat perwakilan layanan. Tag "-Tags {WindowsAzureActiveDirectoryIntegratedApp}" digunakan untuk membuat perwakilan layanan ini muncul dalam daftar Aplikasi Terintegrasi di Portal Admin.

Parameter

-AccountEnabled

true jika akun perwakilan layanan diaktifkan; jika tidak, salah.

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

-AlternativeNames

Nama alternatif untuk perwakilan layanan ini

Type:List<T>[String]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-AppId

Pengidentifikasi unik untuk aplikasi terkait (properti appId-nya).

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

-AppRoleAssignmentRequired

Menunjukkan apakah penetapan peran aplikasi diperlukan.

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

-DisplayName

Menentukan nama tampilan.

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

-ErrorUrl

Menentukan URL kesalahan.

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

-Homepage

Menentukan halaman beranda.

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

-KeyCredentials

Pengumpulan kredensial utama yang terkait dengan perwakilan layanan.

Type:List<T>[Microsoft.Open.AzureAD.Model.KeyCredential]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-LogoutUrl

Menentukan URL keluar.

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

-PasswordCredentials

Menentukan kredensial kata sandi.

Type:List<T>[Microsoft.Open.AzureAD.Model.PasswordCredential]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PublisherName

Menentukan nama penerbit.

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

-ReplyUrls

URL yang dikirim token pengguna untuk masuk dengan aplikasi terkait, atau URI pengalihan tempat kode otorisasi OAuth 2.0 dan token akses dikirim untuk aplikasi terkait.

Type:List<T>[String]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SamlMetadataUrl

URL untuk metadata SAML

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

-ServicePrincipalNames

Menentukan array nama perwakilan layanan. Berdasarkan koleksi identifierURIs, ditambah properti appId aplikasi, URI ini digunakan untuk mereferensikan perwakilan layanan aplikasi. Klien akan menggunakan ini untuk:

  • isi requiredResourceAccess, melalui "Izin ke aplikasi lain" di portal klasik Azure. - tentukan URI sumber daya untuk memperoleh token akses, yang merupakan URI yang dikembalikan dalam klaim.
Type:List<T>[String]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ServicePrincipalType

Jenis THe dari perwakilan layanan

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

-Tags

Tag yang ditautkan ke perwakilan layanan ini.

Perhatikan bahwa jika Anda ingin perwakilan layanan ini muncul di daftar Semua Aplikasi di portal admin, Anda perlu mengatur nilai ini ke {WindowsAzureActiveDirectoryIntegratedApp}

Type:List<T>[String]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Catatan

Lihat panduan migrasi untuk New-AzureADServicePrincipal ke Microsoft Graph PowerShell.