New-AXModel

New-AXModel

Creates an empty model in a Microsoft Dynamics AX model store.

Syntax

Parameter Set: Default
New-AXModel [-Config <String> ] [-Database <String> ] [-Layer <String> ] [-ManifestFile <String> ] [-ManifestProperty <String> ] [-Model <String> ] [-Server <String> ] [ <CommonParameters>]

Detailed description

The New-AXModel cmdlet creates an empty model in a Microsoft Dynamics AX model store. You can pass in either a manifest file or a series of manifest properties to specify properties for the model.

Parameters

-Config<String>

Specifies an Application Object Server (AOS) configuration to use to determine the model store database and server name. The default value is the configuration that is currently active. This parameter cannot be used with the Database or Server parameters. If no Database or Server parameters are supplied, the default configuration is used.

-Database<String>

Specifies the database that contains the Microsoft Dynamics AX model store. This parameter cannot be used with the -Config parameter. If the -Database parameter is specified without a -Server parameter, the default server value of "(local)" is used.

-Layer<String>

Specifies the layer to create the new model in.

-ManifestFile<String>

Specifies an XML file that contains descriptive properties of a model (a model manifest file). Use the Get-AXModelManifest cmdlet with the -Xml parameter to output a sample manifest file. The properties that can be set include the following, with the data type indicated in parentheses: Name (String), DisplayName (String), Description (String), Publisher (String), InstallMode (String), Version, Layer (String).
Version is a four-part indicator, in the format Number.Number.Number.Number, for example, 6.0.0.0.
Possible values for InstallMode are Standard, Overwrite, and Conflict. Standard stops the import process if a conflicting ID is encountered. Overwrite replaces the existing model element with the imported model element. Conflict duplicates the model element into the related update layer. For example, for the ISV layer, the update layer is ISP. The default value is Standard.

-ManifestProperty<String>

Specifies descriptive properties of a model to set. The properties that can be set include the following, with data type indicated in parentheses: Name (String), DisplayName (String), Description (String), Publisher (String), InstallMode (String), Version, Layer (String).
Version is a four-part indicator, in the format Number.Number.Number.Number, for example, 6.0.0.0.
Possible values for InstallMode are Standard, Overwrite, and Conflict. Standard stops the import process if a conflicting ID is encountered. Overwrite replaces the existing model element with the imported model element. Conflict duplicates the model element into the related update layer. For example, for the ISV layer, the update layer is ISP. The default value is Standard.
Properties can be specified in the format <property>:value

-Model<String>

Specifies the name of the model to create.

-Server<String>

Specifies the server that hosts the Microsoft Dynamics AX database. This parameter can only be used with the -Database parameter--it cannot be used by itself.

<CommonParameters>

This cmdlet supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, OutBuffer, OutVariable, WarningAction, and WarningVariable. For more information, see about_CommonParameters http://go.microsoft.com/fwlink/?LinkID=113216

Inputs

The input type is the type of the objects that you can pipe to the cmdlet.

• None

  You cannot pipe input to this cmdlet.

Outputs

The output type is the type of the objects that the cmdlet emits.

• ModelManifest

  Returns the model manifest class.

Examples

This example creates a new model named TestModel in the ISV layer.

C:\PS>New-AXModel -Model TestModel -Layer ISV

Related topics

How to: Create a New Model from the Command Line

Copyright Microsoft Corporation. All rights reserved.