New-AzureADMSApplication

Referencia

Modul:: AzureAD

Létrehoz (regisztrál) egy új alkalmazásobjektumot.

Syntax

New-AzureADMSApplication
   [-AddIns <System.Collections.Generic.List`1[Microsoft.Open.MSGraph.Model.AddIn]>]
   [-Api <ApiApplication>]
   [-AppRoles <System.Collections.Generic.List`1[Microsoft.Open.MSGraph.Model.AppRole]>]
   [-GroupMembershipClaims <String>]
   [-IsDeviceOnlyAuthSupported <Boolean>]
   [-IsFallbackPublicClient <Boolean>]
   [-IdentifierUris <System.Collections.Generic.List`1[System.String]>]
   -DisplayName <String>
   [-InformationalUrl <InformationalUrl>]
   [-KeyCredentials <System.Collections.Generic.List`1[Microsoft.Open.MSGraph.Model.KeyCredential]>]
   [-OptionalClaims <OptionalClaims>]
   [-ParentalControlSettings <ParentalControlSettings>]
   [-PasswordCredentials <System.Collections.Generic.List`1[Microsoft.Open.MSGraph.Model.PasswordCredential]>]
   [-PublicClient <PublicClientApplication>]
   [-RequiredResourceAccess <System.Collections.Generic.List`1[Microsoft.Open.MSGraph.Model.RequiredResourceAccess]>]
   [-SignInAudience <String>]
   [-Tags <System.Collections.Generic.List`1[System.String]>]
   [-TokenEncryptionKeyId <String>]
   [-Web <WebApplication>]
   [<CommonParameters>]

Description

Létrehoz (regisztrál) egy új alkalmazásobjektumot.

Példák

1. példa: Alkalmazás létrehozása

PS C:\>New-AzureADMSApplication -DisplayName "My new application"  -IdentifierUris "http://mynewapp.contoso.com"

          ObjectId                             AppId                                DisplayName
          --------                             -----                                -----------
          acd10942-5747-4385-8824-4c5d5fa904f9 b5fecfab-0ea2-4fd1-8570-b2c41b3d5149 My new application

Ez a parancs létrehoz egy alkalmazást az Azure AD-ben.

2. példa: Alkalmazás létrehozása

PS C:\>New-AzureADMSApplication `
          -DisplayName "my name" `
          -AddIns @{ Type = "mytype"; Properties = [PSCustomObject]@{ Key = "key"; Value = "value" } } `
          -Api @{ AcceptMappedClaims = $true } `
          -AppRoles @{ Id = "21111111-1111-1111-1111-111111111111"; DisplayName = "role"; AllowedMemberTypes = "User"; Description = "mydescription"; Value = "myvalue" } `
          -InformationalUrl @{ SupportUrl = "https://mynewapp.contoso.com/support.html" } `
          -IsDeviceOnlyAuthSupported $false `
          -IsFallbackPublicClient $false `
          -KeyCredentials @{ KeyId = "11111111-1111-1111-1111-111111111111"; Usage = "Encrypt"; Key = {cert}; Type = "AsymmetricX509Cert" } `
          -OptionalClaims @{ IdToken = [PSCustomObject]@{ Name = "claimName"; Source = "claimSource" } } `
          -ParentalControlSettings @{ LegalAgeGroupRule = "Block" } `
          -PublicClient @{ RedirectUris = "https://mynewapp.contoso.com/" } `
          -RequiredResourceAccess @{ ResourceAppId = "31111111-1111-1111-1111-111111111111"; ResourceAccess = [PSCustomObject]@{ Type = "Scope" } } `
          -SignInAudience AzureADandPersonalMicrosoftAccount `
          -Tags "mytag" `
          -TokenEncryptionKeyId "11111111-1111-1111-1111-111111111111" `
          -Web @{ LogoutUrl = "https://mynewapp.contoso.com/logout.html" } `
          -GroupMembershipClaims "SecurityGroup" `
          -PasswordCredentials {passwordcredentials}

          Id                        : 6a32197d-6f56-4980-b127-8f0bff362245
          OdataType                 :
          AddIns                    : {class AddIn {
          Id: 4bd3715c-f089-4e88-9619-c34af1fb9519
          Type: mytype
          Properties: System.Collections.Generic.List`1[Microsoft.Open.MSGraph.Model.KeyValue]
          }
          }
          Api                       : class ApiApplication {
          AcceptMappedClaims:
          KnownClientApplications:
          PreAuthorizedApplications:
          RequestedAccessTokenVersion: 2
          Oauth2PermissionScopes:
          System.Collections.Generic.List`1[Microsoft.Open.MSGraph.Model.PermissionScope]

          AppId                     : 4095dbc0-2095-42d3-b631-7a48eeede86c
          ApplicationTemplateId     :
          AppRoles                  : {class AppRole {
          AllowedMemberTypes: System.Collections.Generic.List`1[System.String]
          Description: mydescription
          DisplayName: role
          Id: 21111111-1111-1111-1111-111111111111
          IsEnabled: True
          Origin: Application
          Value: myvalue
          }
          }
          GroupMembershipClaims     : SecurityGroup
          IsDeviceOnlyAuthSupported : False
          IsFallbackPublicClient    : False
          IdentifierUris            : {}
          CreatedDateTime           :
          DeletedDateTime           :
          DisplayName               : my name
          Info                      : class InformationalUrl {
          TermsOfServiceUrl:
          MarketingUrl:
          PrivacyStatementUrl:
          SupportUrl: https://mynewapp.contoso.com/support.html
          LogoUrl:
          }

          KeyCredentials            : {class KeyCredential {
          CustomKeyIdentifier: System.Byte[]
          DisplayName:
          EndDateTime:
          KeyId: 11111111-1111-1111-1111-111111111111
          StartDateTime:
          Type: AsymmetricX509Cert
          Usage: Encrypt
          Key:
          }
          }
          OptionalClaims            : class OptionalClaims {
          IdToken: System.Collections.Generic.List`1[Microsoft.Open.MSGraph.Model.OptionalClaim]
          AccessToken:
          System.Collections.Generic.List`1[Microsoft.Open.MSGraph.Model.OptionalClaim]
          Saml2Token: System.Collections.Generic.List`1[Microsoft.Open.MSGraph.Model.OptionalClaim]
          }

          ParentalControlSettings   : class ParentalControlSettings {
          CountriesBlockedForMinors: System.Collections.Generic.List`1[System.String]
          LegalAgeGroupRule: BlockMinors
          }

          PasswordCredentials       : {}
          PublicClient              : class PublicClientApplication {
          RedirectUris: System.Collections.Generic.List`1[System.String]
          }

          PublisherDomain           :
          RequiredResourceAccess    : {class RequiredResourceAccess {
          ResourceAppId: 31111111-1111-1111-1111-111111111111
          ResourceAccess:
          System.Collections.Generic.List`1[Microsoft.Open.MSGraph.Model.ResourceAccess]
          }
          }
          SignInAudience            : AzureADandPersonalMicrosoftAccount
          Tags                      : {mytag}
          TokenEncryptionKeyId      : 11111111-1111-1111-1111-111111111111
          Web                       : class WebApplication {
          HomePageUrl:
          LogoutUrl: https://mynewapp.contoso.com/logout.html
          RedirectUris: System.Collections.Generic.List`1[System.String]
          ImplicitGrantSettings: class ImplicitGrantSettings {
          EnableIdTokenIssuance: False
          EnableAccessTokenIssuance: False
          }

          }

Ez a parancs létrehoz egy alkalmazást az Azure AD-ben.

Paraméterek

-AddIns

Olyan egyéni viselkedést határoz meg, amellyel a fogyasztó szolgáltatás adott környezetben hívhat meg alkalmazásokat. A fájlstreameket megjelenítő alkalmazások például beállíthatják az addIns tulajdonságot a "FileHandler" funkcióhoz. Így az Office 365-höz hasonló szolgáltatások meghívják az alkalmazást egy olyan dokumentum kontextusában, amelyen a felhasználó dolgozik.

Típus:	List<T>[Microsoft.Open.MSGraph.Model.AddIn]
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-Api

Egy webes API-t implementáló alkalmazás beállításait adja meg.

Típus:	ApiApplication
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-AppRoles

Az alkalmazás által deklarálható alkalmazásszerepkörök gyűjteménye. Ezek a szerepkörök felhasználókhoz, csoportokhoz vagy szolgáltatásnevekhez rendelhetők.

Típus:	List<T>[Microsoft.Open.MSGraph.Model.AppRole]
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-DisplayName

Az alkalmazás megjelenítendő nevét adja meg.

Típus:	String
Position:	Named
Alapértelmezett érték:	None
Kötelező:	True
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-GroupMembershipClaims

Konfigurálja a felhasználóban vagy az OAuth 2.0 hozzáférési jogkivonatban kibocsátott csoportjogkivonatot, amelyet az alkalmazás elvár.

Típus:	String
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-IdentifierUris

Felhasználó által definiált URI-k, amelyek egyedileg azonosítanak egy webalkalmazást az Azure AD-bérlőn belül vagy egy ellenőrzött egyéni tartományban (lásd a klasszikus Azure portál "Tartományok" lapját), ha az alkalmazás több-bérlős.

Az első elem a webalkalmazás "APP ID URI" mezőjéből lesz feltöltve, ha a klasszikus Azure portálon (vagy a megfelelő Azure AD PowerShell-parancsmagparaméteren) keresztül frissítjük. További URI-k hozzáadhatók az alkalmazásjegyzéken keresztül; A részletekért lásd: Az Azure AD alkalmazásjegyzékének ismertetése. Ez a gyűjtemény a webalkalmazás servicePrincipalNames gyűjteményének feltöltésére is használható.

Típus:	List<T>[String]
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-InformationalUrl

Az alkalmazás alapvető profiladatai, például az alkalmazás marketingje, támogatása, szolgáltatási feltételei és adatvédelmi nyilatkozatának URL-címei. A szolgáltatási feltételek és az adatvédelmi nyilatkozat a felhasználói hozzájárulási felületen jelenik meg a felhasználók számára.

Típus:	InformationalUrl
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-IsDeviceOnlyAuthSupported

Meghatározza, hogy az alkalmazás támogatja-e az eszközjogkivonattal történő hitelesítést.

Típus:	Boolean
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-IsFallbackPublicClient

A tartalék alkalmazás típusát adja meg nyilvános ügyfélként, például egy mobileszközön futó telepített alkalmazást. Az alapértelmezett érték hamis, ami azt jelenti, hogy a tartalék alkalmazás típusa bizalmas ügyfél, például webalkalmazás. Vannak olyan esetek, amikor az Azure AD nem tudja meghatározni az ügyfélalkalmazás típusát (pl. ROPC-folyamat, ahol az átirányítási URI megadása nélkül van konfigurálva). Ezekben az esetekben az Azure AD a tulajdonság értéke alapján értelmezi az alkalmazás típusát.

Típus:	Boolean
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-KeyCredentials

Az alkalmazáshoz társított kulcs hitelesítő adatok gyűjteménye

Típus:	List<T>[Microsoft.Open.MSGraph.Model.KeyCredential]
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-OptionalClaims

Az alkalmazásfejlesztők opcionális jogcímeket konfigurálhatnak az Azure AD-alkalmazásaikban, hogy megadják, mely jogcímeket szeretnék az alkalmazásuknak a Microsoft biztonsági jogkivonat-szolgáltatása által küldött jogkivonatokban megadni.

Típus:	OptionalClaims
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-ParentalControlSettings

Az alkalmazás szülői felügyeleti beállításait adja meg.

Típus:	ParentalControlSettings
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-PasswordCredentials

Az alkalmazáshoz társított jelszó-hitelesítő adatok gyűjteménye

Típus:	List<T>[Microsoft.Open.MSGraph.Model.PasswordCredential]
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-PublicClient

Meghatározza, hogy ez az alkalmazás nyilvános ügyfél-e (például mobileszközön futó telepített alkalmazás). Az alapértelmezett érték a false (hamis).

Típus:	PublicClientApplication
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-RequiredResourceAccess

Meghatározza azokat az erőforrásokat, amelyekhez az alkalmazásnak hozzáférésre van szüksége, valamint az OAuth-engedély hatóköreinek és alkalmazásszerepköreinek készletét, amelyekre az egyes erőforrásokhoz szüksége van. A szükséges erőforrás-hozzáférés ezen előkonfigurációja vezérli a hozzájárulási felületet.

Típus:	List<T>[Microsoft.Open.MSGraph.Model.RequiredResourceAccess]
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-SignInAudience

Meghatározza, hogy mely Microsoft-fiókok támogatottak az aktuális alkalmazáshoz.

Típus:	String
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-Tags

Az alkalmazás kategorizálásához és azonosításához használható egyéni sztringek.

Típus:	List<T>[String]
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-TokenEncryptionKeyId

Egy nyilvános kulcs kulcsazonosítóját adja meg a keyCredentials gyűjteményből. Ha konfigurálva van, az Azure AD az általa kibocsátott összes jogkivonatot titkosítja a tulajdonság által használt kulcs használatával. A titkosított jogkivonatot fogadó alkalmazáskódnak a megfelelő titkos kulcsot kell használnia a jogkivonat visszafejtéséhez, mielőtt a bejelentkezett felhasználó számára használható lenne.

Típus:	String
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-Web

Webalkalmazás beállításait adja meg.

Típus:	WebApplication
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

Bevitelek

Boolean

Microsoft.Open.MSGraph.Model.ApiApplication

Microsoft.Open.MSGraph.Model.InformationalUrl

Microsoft.Open.MSGraph.Model.OptionalClaims

Microsoft.Open.MSGraph.Model.ParentalControlSettings

Microsoft.Open.MSGraph.Model.PublicClientApplication

Microsoft.Open.MSGraph.Model.WebApplication

String

List<T>[Microsoft.Open.MSGraph.Model.AddIn]

List<T>[Microsoft.Open.MSGraph.Model.AppRole]

List<T>[Microsoft.Open.MSGraph.Model.KeyCredential]

List<T>[Microsoft.Open.MSGraph.Model.PasswordCredential]

List<T>[Microsoft.Open.MSGraph.Model.RequiredResourceAccess]

List<T>[String]

Nullable<T>[Boolean]

Kimenetek

Microsoft.Open.MSGraph.Model.MsApplication

Megosztás a következőn keresztül:

New-AzureADMSApplication

Syntax

Description

Példák

1. példa: Alkalmazás létrehozása

2. példa: Alkalmazás létrehozása

Paraméterek

-AddIns

-Api

-AppRoles

-DisplayName

-GroupMembershipClaims

-IdentifierUris

-InformationalUrl

-IsDeviceOnlyAuthSupported

-IsFallbackPublicClient

-KeyCredentials

-OptionalClaims

-ParentalControlSettings

-PasswordCredentials

-PublicClient

-RequiredResourceAccess

-SignInAudience

-Tags

-TokenEncryptionKeyId

-Web

Bevitelek

Kimenetek

Visszajelzés

További források

Megosztás a következőn keresztül:

New-AzureADMSApplication

Syntax

Description

Példák

1. példa: Alkalmazás létrehozása

2. példa: Alkalmazás létrehozása

Paraméterek

-AddIns

-Api

-AppRoles

-DisplayName

-GroupMembershipClaims

-IdentifierUris

-InformationalUrl

-IsDeviceOnlyAuthSupported

-IsFallbackPublicClient

-KeyCredentials

-OptionalClaims

-ParentalControlSettings

-PasswordCredentials

-PublicClient

-RequiredResourceAccess

-SignInAudience

-Tags

-TokenEncryptionKeyId

-Web

Bevitelek

Kimenetek

Kapcsolódó hivatkozások

Visszajelzés

További források