Test-AXModelData

Important

This content is archived and is not being updated. For the latest documentation, see Microsoft Dynamics 365 product documentation. For the latest release plans, see Dynamics 365 and Microsoft Power Platform release plans.

Test-AXModelData

Verifies whether a specified model or layer contains data.

Syntax

Parameter Set: Default
Test-AXModelData [-Config <String> ] [-Database <String> ] [-Layer <String> ] [-ManifestFile <String> ] [-Model <String> ] [-Server <String> ] [ <CommonParameters>]

Detailed description

The Test-AXModelData cmdlet verifies whether a specified model or layer contains data.

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, -Server, or -Config parameters are supplied, the default configuration is used.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-Database<String>

Specifies the Microsoft Dynamics AX model store database. 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.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-Layer<String>

Specifies a layer to be tested. This parameter is required if the Model parameter has not been specified.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-ManifestFile<String>

Specifies an XML file that identifies a model.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-Model<String>

Specifies a model to be tested. This parameter is required if the Layer parameter has not been specified.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-Server<String>

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

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

<CommonParameters>

This cmdlet supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, OutBuffer, OutVariable, WarningAction, and WarningVariable. For more information, see about_CommonParameters https://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 tests whether the USR layer contains data, and displays the outcome to the screen.

PS C:\>Test-AXModelData -Layer USR -Verbose
VERBOSE: AXUtil 6.0 - Microsoft Dynamics AX Admin Utility (6.0.906.0)
(c) Copyright, Microsoft Corporation, 2011. All rights reserved.

VERBOSE:
VERBOSE: The AXUtil command was started in the mode: EXISTS.
VERBOSE:
VERBOSE: Working against model store RDVM806000-GU/MicrosoftDynamicsAX.
VERBOSE:
VERBOSE: Model data exists in Usr layer.
VERBOSE:
PS C:\>
                        

How to: View and verify contents of a model

Copyright Microsoft Corporation. All rights reserved.