< Back
Add-AxEnvironmentConfig
Post
NAME Add-AxEnvironmentConfig
SYNOPSIS
Add configuration details for an entire AX 2012 environment
SYNTAX
Add-AxEnvironmentConfig [-Name] <String> [[-AosServers] <String[]>] [[-InstanceName] <String>] [[-DatabaseServers]
<String[]>] [[-Database] <String>] [[-ModelstoreDatabase] <String>] [[-SsrsServers] <String[]>] [[-EpServers]
<String[]>] [[-WmdpServers] <String[]>] [[-Mr2012Servers] <String[]>] [[-SsasServers] <String[]>] [-Append]
[-Force] [-Temporary] [<CommonParameters>]
DESCRIPTION
Build a configuration containing all the different servers / machines that is part of any given AX 2012 environment
You could register your TEST, SAT, UAT, PROD environment and easily switch between them when you want to
troubleshoot or run maintenance work against them
PARAMETERS
-Name <String>
Name of the environment that you are adding
Required? true
Position? 1
Default value
Accept pipeline input? false
Accept wildcard characters? false
-AosServers <String[]>
Array with server names of all the servers that host an AOS instance in the specific environment
Required? false
Position? 2
Default value
Accept pipeline input? false
Accept wildcard characters? false
-InstanceName <String>
Name of the instance that is used to uniquely identify the environment across multiple AOS instances
Required? false
Position? 3
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-DatabaseServers <String[]>
Array with server names of all the servers that host a SQL Server database for the environment
Required? false
Position? 4
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-Database <String>
Database name for the SQL Server database that the AOS instance(s) connects to
Required? false
Position? 5
Default value
Accept pipeline input? false
Accept wildcard characters? false
-ModelstoreDatabase <String>
Database name for the SQL Server database that holds the modelstore (code)
Required? false
Position? 6
Default value
Accept pipeline input? false
Accept wildcard characters? false
-SsrsServers <String[]>
Array with server names of all the servers that host a Sql Server Reporting Services (SSRS) instance in the
specific environment
Required? false
Position? 7
Default value
Accept pipeline input? false
Accept wildcard characters? false
-EpServers <String[]>
Array with server names of all the servers that host a SharePoint installation with corresponding Enterprise
Portal components in the specific environment
Required? false
Position? 8
Default value
Accept pipeline input? false
Accept wildcard characters? false
-WmdpServers <String[]>
Array with server names of all the servers that host an IIS installation with corresponding Warehouse Mobile
Device Portal (WMDP) components in the specific environment
Required? false
Position? 9
Default value
Accept pipeline input? false
Accept wildcard characters? false
-Mr2012Servers <String[]>
Array with server names of all the servers that host a Management Reporter 2012 instance in the specific
environment
Required? false
Position? 10
Default value
Accept pipeline input? false
Accept wildcard characters? false
-SsasServers <String[]>
Array with server names of all the servers that host a Sql Server Analysis Services (SSAS) instance in the
specific environment
Required? false
Position? 11
Default value
Accept pipeline input? false
Accept wildcard characters? false
-Append [<SwitchParameter>]
Instructs the cmdlet to append the different parameter values with those that might already exist in the
configuration store
Required? false
Position? named
Default value False
Accept pipeline input? false
Accept wildcard characters? false
-Force [<SwitchParameter>]
Instruct the cmdlet to overwrite the specified parameter values in the configuration store
Required? false
Position? named
Default value False
Accept pipeline input? false
Accept wildcard characters? false
-Temporary [<SwitchParameter>]
Instruct the cmdlet to only temporarily add the environment configuration in the configuration store
Great help while building the configuration and you don't want to persist the configuration on the machine
Required? false
Position? named
Default value False
Accept pipeline input? false
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https:/go.microsoft.com/fwlink/?LinkID=113216).
INPUTS
OUTPUTS
NOTES
Tags: Environment, Config, Configuration, Servers
Author: M??????tz Jensen (@Splaxi)
-------------------------- EXAMPLE 1 --------------------------
PS C:\\>Add-AxEnvironmentConfig -Name AXTEST -AosServers TESTAOS01 -InstanceName AXTEST -DatabaseServers TESTSQL01
-Database AXTEST -ModelstoreDatabase AXTEST_model -Temporary
This adds a new environment configuration to the configuration store.
The Name AXTEST is used as the name for the configuration of the environment.
The InstanceName AXTEST is used as the instance name for the configuration of the environment.
The server TESTAOS01 is registered as the AOS Server.
The server TESTSQL01 is registered as the SQL Server.
The database AXTEST is registered as the SQL Server database.
The database AXTEST_model is registered as the SQL Server database for the modelstore.
RELATED LINKS
Clear-AxActiveEnvironmentConfig
Get-AxActiveEnvironmentConfig
Get-AxEnvironmentConfig
Remove-AxEnvironmentConfig
Set-AxActiveEnvironmentConfig
SYNOPSIS
Add configuration details for an entire AX 2012 environment
SYNTAX
Add-AxEnvironmentConfig [-Name] <String> [[-AosServers] <String[]>] [[-InstanceName] <String>] [[-DatabaseServers]
<String[]>] [[-Database] <String>] [[-ModelstoreDatabase] <String>] [[-SsrsServers] <String[]>] [[-EpServers]
<String[]>] [[-WmdpServers] <String[]>] [[-Mr2012Servers] <String[]>] [[-SsasServers] <String[]>] [-Append]
[-Force] [-Temporary] [<CommonParameters>]
DESCRIPTION
Build a configuration containing all the different servers / machines that is part of any given AX 2012 environment
You could register your TEST, SAT, UAT, PROD environment and easily switch between them when you want to
troubleshoot or run maintenance work against them
PARAMETERS
-Name <String>
Name of the environment that you are adding
Required? true
Position? 1
Default value
Accept pipeline input? false
Accept wildcard characters? false
-AosServers <String[]>
Array with server names of all the servers that host an AOS instance in the specific environment
Required? false
Position? 2
Default value
Accept pipeline input? false
Accept wildcard characters? false
-InstanceName <String>
Name of the instance that is used to uniquely identify the environment across multiple AOS instances
Required? false
Position? 3
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-DatabaseServers <String[]>
Array with server names of all the servers that host a SQL Server database for the environment
Required? false
Position? 4
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-Database <String>
Database name for the SQL Server database that the AOS instance(s) connects to
Required? false
Position? 5
Default value
Accept pipeline input? false
Accept wildcard characters? false
-ModelstoreDatabase <String>
Database name for the SQL Server database that holds the modelstore (code)
Required? false
Position? 6
Default value
Accept pipeline input? false
Accept wildcard characters? false
-SsrsServers <String[]>
Array with server names of all the servers that host a Sql Server Reporting Services (SSRS) instance in the
specific environment
Required? false
Position? 7
Default value
Accept pipeline input? false
Accept wildcard characters? false
-EpServers <String[]>
Array with server names of all the servers that host a SharePoint installation with corresponding Enterprise
Portal components in the specific environment
Required? false
Position? 8
Default value
Accept pipeline input? false
Accept wildcard characters? false
-WmdpServers <String[]>
Array with server names of all the servers that host an IIS installation with corresponding Warehouse Mobile
Device Portal (WMDP) components in the specific environment
Required? false
Position? 9
Default value
Accept pipeline input? false
Accept wildcard characters? false
-Mr2012Servers <String[]>
Array with server names of all the servers that host a Management Reporter 2012 instance in the specific
environment
Required? false
Position? 10
Default value
Accept pipeline input? false
Accept wildcard characters? false
-SsasServers <String[]>
Array with server names of all the servers that host a Sql Server Analysis Services (SSAS) instance in the
specific environment
Required? false
Position? 11
Default value
Accept pipeline input? false
Accept wildcard characters? false
-Append [<SwitchParameter>]
Instructs the cmdlet to append the different parameter values with those that might already exist in the
configuration store
Required? false
Position? named
Default value False
Accept pipeline input? false
Accept wildcard characters? false
-Force [<SwitchParameter>]
Instruct the cmdlet to overwrite the specified parameter values in the configuration store
Required? false
Position? named
Default value False
Accept pipeline input? false
Accept wildcard characters? false
-Temporary [<SwitchParameter>]
Instruct the cmdlet to only temporarily add the environment configuration in the configuration store
Great help while building the configuration and you don't want to persist the configuration on the machine
Required? false
Position? named
Default value False
Accept pipeline input? false
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https:/go.microsoft.com/fwlink/?LinkID=113216).
INPUTS
OUTPUTS
NOTES
Tags: Environment, Config, Configuration, Servers
Author: M??????tz Jensen (@Splaxi)
-------------------------- EXAMPLE 1 --------------------------
PS C:\\>Add-AxEnvironmentConfig -Name AXTEST -AosServers TESTAOS01 -InstanceName AXTEST -DatabaseServers TESTSQL01
-Database AXTEST -ModelstoreDatabase AXTEST_model -Temporary
This adds a new environment configuration to the configuration store.
The Name AXTEST is used as the name for the configuration of the environment.
The InstanceName AXTEST is used as the instance name for the configuration of the environment.
The server TESTAOS01 is registered as the AOS Server.
The server TESTSQL01 is registered as the SQL Server.
The database AXTEST is registered as the SQL Server database.
The database AXTEST_model is registered as the SQL Server database for the modelstore.
RELATED LINKS
Clear-AxActiveEnvironmentConfig
Get-AxActiveEnvironmentConfig
Get-AxEnvironmentConfig
Remove-AxEnvironmentConfig
Set-AxActiveEnvironmentConfig