New-AzureADServicePrincipal

  • Odwołanie
Moduł:
AzureAD

Tworzy jednostkę usługi.

Składnia

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>]

Przykłady

Przykład 1. Tworzenie jednostki usługi

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

To polecenie tworzy jednostkę usługi. Tag "-Tags {WindowsAzureActiveDirectoryIntegratedApp}" służy do wyświetlania tej jednostki usługi na liście zintegrowanych aplikacji w portalu Administracja.

Parametry

-AccountEnabled

wartość true, jeśli konto jednostki usługi jest włączone; w przeciwnym razie, fałsz.

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

-AlternativeNames

Alternatywne nazwy tej jednostki usługi

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

-AppId

Unikatowy identyfikator skojarzonej aplikacji (jej właściwość appId).

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

-AppRoleAssignmentRequired

Wskazuje, czy przypisanie roli aplikacji jest wymagane.

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

-DisplayName

Określa nazwę wyświetlaną.

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

-ErrorUrl

Określa adres URL błędu.

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

-Homepage

Określa stronę główną.

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

-KeyCredentials

Kolekcja poświadczeń klucza skojarzonych z jednostką usługi.

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

-LogoutUrl

Określa adres URL wylogowywania.

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

-PasswordCredentials

Określa poświadczenia hasła.

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

-PublisherName

Określa nazwę wydawcy.

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

-ReplyUrls

Adresy URL, do których są wysyłane tokeny użytkownika w celu logowania się do skojarzonej aplikacji lub identyfikatory URI przekierowania, do których są wysyłane kody autoryzacji protokołu OAuth 2.0 i tokeny dostępu dla skojarzonej aplikacji.

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

-SamlMetadataUrl

Adres URL metadanych SAML

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

-ServicePrincipalNames

Określa tablicę nazw głównych usług. Na podstawie kolekcji identifierURIs oraz właściwości appId aplikacji te identyfikatory URI są używane do odwołowania się do jednostki usługi aplikacji. Klient użyje następujących opcji do:

  • wypełnij wartość requiredResourceAccess za pośrednictwem pozycji "Uprawnienia do innych aplikacji" w klasycznym portalu Azure. — określ identyfikator URI zasobu, aby uzyskać token dostępu, który jest identyfikatorem URI zwróconym w oświadczeniu.
Type:List<T>[String]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ServicePrincipalType

Typ jednostki usługi

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

-Tags

Tagi połączone z tą jednostką usługi.

Pamiętaj, że jeśli ta jednostka usługi ma być wyświetlana na liście Wszystkie aplikacje w portalu administracyjnym, musisz ustawić tę wartość na {WindowsAzureActiveDirectoryIntegratedApp}

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

Uwagi

Zobacz przewodnik migracji dla polecenia New-AzureADServicePrincipal w programie Microsoft Graph PowerShell.