New-AzureADMSApplication

參考

模組:: AzureADPreview

建立 () 新的應用程式對象註冊。

語法

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>]
   [-OrgRestrictions <System.Collections.Generic.List`1[System.String]>]
   [-ParentalControlSettings <ParentalControlSettings>]
   [-PasswordCredentials <System.Collections.Generic.List`1[Microsoft.Open.MSGraph.Model.PasswordCredential]>]
   [-PreAuthorizedApplications <System.Collections.Generic.List`1[Microsoft.Open.MSGraph.Model.PreAuthorizedApplication]>]
   [-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

建立 () 新的應用程式對象註冊。

範例

範例 1：建立應用程式

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

此命令會在 Azure AD 中建立應用程式。

範例 2：建立應用程式

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" `
          -OrgRestrictions {orgrestrictions}
          -PasswordCredentials {passwordcredentials}
          -PreAuthorizedApplications {preauthorizedapplications}

          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]
          ResourceSpecificApplicationPermissions:
          }

          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
          }

          }

此命令會在 Azure AD 中建立應用程式。

參數

-AddIns

定義取用服務可用來在特定內容中呼叫應用程式的自訂行為。例如，可以轉譯檔案資料流的應用程式可能會為其 "FileHandler" 功能設定 addIns 屬性。這可讓如 Office 365 等服務在使用者目前正在處理的文件內容中呼叫應用程式。

類型:	List<T>[Microsoft.Open.MSGraph.Model.AddIn]
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Api

指定實作 Web API 之應用程式的設定。

類型:	ApiApplication
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-AppRoles

應用程式可以宣告的應用程式角色的集合。這些角色可以指派給使用者、群組或服務主體。

類型:	List<T>[Microsoft.Open.MSGraph.Model.AppRole]
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-DisplayName

指定應用程式的顯示名稱。

類型:	String
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-GroupMembershipClaims

設定應用程式預期在使用者或 OAuth 2.0 存取令牌中發出的群組宣告。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-IdentifierUris

使用者定義的 URI () ，可唯一識別其 Azure AD 租使用者內的 Web 應用程式，或在已驗證的自定義網域內 (如果應用程式是多租使用者，請參閱 Azure 傳統入口網站中的 [網域] 索引卷標) 。

如果透過 Azure 傳統入口網站 (或個別的 Azure AD PowerShell Cmdlet 參數) 更新，則會從 Web 應用程式的 [應用程式識別符 URI] 字段填入第一個專案。您可以透過應用程式指令清單新增其他 URI;如需詳細資訊，請參閱瞭解 Azure AD 應用程式指令清單。這個集合也可用來填入 Web 應用程式的 servicePrincipalNames 集合。

類型:	List<T>[String]
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-InformationalUrl

應用程式的基本配置檔資訊，例如應用程式的行銷、支援、服務條款和隱私聲明 URL。使用者會透過使用者同意體驗看到服務條款和隱私權聲明。

類型:	InformationalUrl
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-IsDeviceOnlyAuthSupported

指定應用程式是否支援使用裝置令牌進行驗證。

類型:	Boolean
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-IsFallbackPublicClient

將後援應用程式類型指定為公用用戶端，例如在行動裝置上執行的已安裝應用程式。預設值為 false，這表示後援應用程式類型是機密用戶端，例如 Web 應用程式。在某些情況下，Azure AD 無法判斷用戶端應用程式類型 (例如，設定的 ROPC 流程，而不需指定重新導向 URI) 。在這些情況下，Azure AD 會根據這個屬性的值來解譯應用程式類型。

類型:	Boolean
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-KeyCredentials

與應用程式相關聯的金鑰認證集合

類型:	List<T>[Microsoft.Open.MSGraph.Model.KeyCredential]
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-OptionalClaims

應用程式開發人員可以在其 Azure AD 應用程式中設定選擇性宣告，以指定他們在 Microsoft 安全性令牌服務傳送至其應用程式的令牌中想要的宣告。

類型:	OptionalClaims
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-OrgRestrictions

保留供未來使用。

類型:	List<T>[String]
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-ParentalControlSettings

指定應用程式的家長控制設定。

類型:	ParentalControlSettings
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-PasswordCredentials

與應用程式相關聯的密碼認證集合

類型:	List<T>[Microsoft.Open.MSGraph.Model.PasswordCredential]
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-PreAuthorizedApplications

列出需要隱含同意的應用程式和要求的權限。需要管理員已向應用程式提供同意。 preAuthorizedApplications 不需要使用者同意要求的權限。 PreAuthorizedApplications 中所列的權限不需要使用者同意。不過，preAuthorizedApplications 中未列出的任何其他要求權限則需要使用者同意。

類型:	List<T>[Microsoft.Open.MSGraph.Model.PreAuthorizedApplication]
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-PublicClient

指定此應用程式是否為公開用戶端 (例如行動裝置上執行的已安裝應用程式)。預設值為 false。

類型:	PublicClientApplication
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-RequiredResourceAccess

指定此應用程式所需存取的資源，並針對每項資源設定此應用程式所需的 OAuth 權限範圍及應用程式角色。預先設定所需的資源存取需要使用者同意。

類型:	List<T>[Microsoft.Open.MSGraph.Model.RequiredResourceAccess]
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-SignInAudience

指定目前的應用程式支援哪些 Microsoft 帳戶。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Tags

可用來分類及識別應用程式的自訂字串。

類型:	List<T>[String]
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-TokenEncryptionKeyId

從keyCredentials集合指定公鑰的keyId。設定時，Azure AD 會使用此屬性所指向的金鑰來加密它發出的所有令牌。接收加密權杖的應用程式程式碼必須先使用對應的私密金鑰來將權杖解密，才能將該權杖用於登入的使用者。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Web

指定 Web 應用程式的設定。

類型:	WebApplication
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

輸入

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

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

List<T>[String]

Nullable<T>[Boolean]

輸出

Microsoft.Open.MSGraph.Model.MsApplication

共用方式為