Aracılığıyla paylaş


New-AzureADMSApplication

Yeni bir uygulama nesnesi oluşturur (kaydeder).

Sözdizimi

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

Yeni bir uygulama nesnesi oluşturur (kaydeder).

Örnekler

Örnek 1: Uygulama oluşturma

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

Bu komut Azure AD'de bir uygulama oluşturur.

Örnek 2: Uygulama oluşturma

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
          }

          }

Bu komut Azure AD'de bir uygulama oluşturur.

Parametreler

-AddIns

Kullanan bir hizmetin belirli bağlamlarda bir uygulamayı çağırmak için kullanabileceği özel davranışı tanımlar. Örneğin, dosya akışlarını işleyebilen uygulamalar addIns özelliğini "FileHandler" işlevselliği için ayarlayabilir. Bu, Office 365 gibi hizmetlerin uygulamayı kullanıcının üzerinde çalıştığı bir belge bağlamında çağırmasına olanak tanır.

Tür:List<T>[Microsoft.Open.MSGraph.Model.AddIn]
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-Api

Web API'sini uygulayan bir uygulamanın ayarlarını belirtir.

Tür:ApiApplication
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-AppRoles

Bir uygulamanın bildirebileceği uygulama rollerinin koleksiyonu. Bu roller kullanıcılara, gruplara veya hizmet sorumlularına atanabilir.

Tür:List<T>[Microsoft.Open.MSGraph.Model.AppRole]
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-DisplayName

Uygulamanın görünen adını belirtir.

Tür:String
Position:Named
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-GroupMembershipClaims

Bir kullanıcıda veya uygulamanın beklediği OAuth 2.0 erişim belirtecinde verilen grup talebi yapılandırılır.

Tür:String
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-IdentifierUris

Bir Web uygulamasını Azure AD kiracısında veya uygulama çok kiracılıysa doğrulanmış bir özel etki alanında (klasik Azure portalında "Etki Alanları" sekmesine bakın) benzersiz olarak tanımlayan kullanıcı tanımlı URI'ler.

İlk öğe, Klasik Azure portalı (veya ilgili Azure AD PowerShell cmdlet parametresi) aracılığıyla güncelleştirilirse Web uygulamasının "APP ID URI" alanından doldurulur. Uygulama bildirimi aracılığıyla ek URI'ler eklenebilir; Ayrıntılar için bkz. Azure AD Uygulama Bildirimi'ni anlama. Bu koleksiyon, Web uygulamasının servicePrincipalNames koleksiyonunu doldurmak için de kullanılır.

Tür:List<T>[String]
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-InformationalUrl

Uygulamanın pazarlama, destek, hizmet koşulları ve gizlilik bildirimi URL'leri gibi uygulamanın temel profil bilgileri. Hizmet koşulları ve gizlilik bildirimi, kullanıcı onayı deneyimi aracılığıyla kullanıcılara sunulur.

Tür:InformationalUrl
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-IsDeviceOnlyAuthSupported

Uygulamanın bir cihaz belirteci kullanarak kimlik doğrulamasını desteklenip desteklemediğini belirtir.

Tür:Boolean
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-IsFallbackPublicClient

Mobil cihazda çalışan yüklü bir uygulama gibi geri dönüş uygulama türünü genel istemci olarak belirtir. Varsayılan değer false'tur, bu da geri dönüş uygulama türünün web uygulaması gibi gizli bir istemci olduğu anlamına gelir. Azure AD'nin istemci uygulama türünü belirleyemediği bazı senaryolar vardır (örneğin, yeniden yönlendirme URI'sini belirtmeden yapılandırıldığı ROPC akışı). Bu gibi durumlarda Azure AD, uygulama türünü bu özelliğin değerine göre yorumlar.

Tür:Boolean
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-KeyCredentials

Uygulamayla ilişkili anahtar kimlik bilgilerinin koleksiyonu

Tür:List<T>[Microsoft.Open.MSGraph.Model.KeyCredential]
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-OptionalClaims

Uygulama geliştiricileri, Microsoft güvenlik belirteci hizmeti tarafından uygulamalarına gönderilen belirteçlerde hangi taleplerin gönderilmesini istediklerini belirtmek için Azure AD uygulamalarında isteğe bağlı beyanları yapılandırabilir.

Tür:OptionalClaims
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-ParentalControlSettings

Bir uygulama için ebeveyn denetimi ayarlarını belirtir.

Tür:ParentalControlSettings
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-PasswordCredentials

Uygulamayla ilişkili parola kimlik bilgilerinin koleksiyonu

Tür:List<T>[Microsoft.Open.MSGraph.Model.PasswordCredential]
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-PublicClient

Bu uygulamanın genel istemci olup olmadığını belirtir (örneğin, mobil cihazda çalışan yüklü bir uygulama). Varsayılan değer false’tur.

Bu uygulamanın genel istemci olup olmadığını belirtir (örneğin, mobil cihazda çalışan yüklü bir uygulama). Varsayılan değer false’tur.

Tür:PublicClientApplication
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-RequiredResourceAccess

Bu uygulamanın erişim gerektirdiği kaynakları ve bu kaynakların her biri altında ihtiyaç duyduğu OAuth izin kapsamları ve uygulama rolleri kümesini belirtir. Gerekli kaynak erişiminin bu ön yapılandırması, onay deneyimini destekler.

Tür:List<T>[Microsoft.Open.MSGraph.Model.RequiredResourceAccess]
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-SignInAudience

Geçerli uygulama için hangi Microsoft hesaplarının desteklendiği belirtir.

Tür:String
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-Tags

Uygulamayı kategorilere ayırmak ve tanımlamak için kullanılabilecek özel dizeler.

Tür:List<T>[String]
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-TokenEncryptionKeyId

keyCredentials koleksiyonundan bir ortak anahtarın keyId değerini belirtir. Yapılandırıldığında Azure AD, bu özelliğin işaret ettiği anahtarı kullanarak yaydığı tüm belirteçleri şifreler. Şifrelenmiş belirteci alan uygulama kodu, oturum açmış kullanıcı için kullanılmadan önce belirtecin şifresini çözmek için eşleşen özel anahtarı kullanmalıdır.

Tür:String
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-Web

Bir web uygulamasının ayarlarını belirtir.

Tür:WebApplication
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

Girişler

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]

Çıkışlar

Microsoft.Open.MSGraph.Model.MsApplication