< Back
Set-AxActiveAosConfig
Post
NAME Set-AxActiveAosConfig
SYNOPSIS
Set the active AX 2012 AOS configuration
SYNTAX
Set-AxActiveAosConfig [[-ComputerName] <String[]>] [[-BinDirectory] <String>] [[-InstanceNumber] <String>]
[[-InstanceName] <String>] [[-DatabaseServer] <String>] [[-DatabaseName] <String>] [[-ModelstoreDatabase]
<String>] [[-AosPort] <String>] [[-WsdlPort] <String>] [[-NetTcpPort] <String>] [-ConfigStorageLocation <String>]
[-Temporary] [-Clear] [<CommonParameters>]
DESCRIPTION
Set the active AX 2012 AOS details and store it into the configuration storage
PARAMETERS
-ComputerName <String[]>
The name of the computer / server that AOS resides on
Required? false
Position? 2
Default value @($env:computername)
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-BinDirectory <String>
The full path to the bin directory where the AOS instance is physical installed
Required? false
Position? 3
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-InstanceNumber <String>
The 2 digit ([0-9][0-9]) number that the AOS instance has on the server
Required? false
Position? 4
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-InstanceName <String>
The instance name the AOS server is registered with
Required? false
Position? 5
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-DatabaseServer <String>
The name of the server running SQL Server
Required? false
Position? 6
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-DatabaseName <String>
The name of the AX 2012 business data database
Required? false
Position? 7
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-ModelstoreDatabase <String>
The name of the AX 2012 modelstore database
Required? false
Position? 8
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-AosPort <String>
The TCP port that the AX 2012 AOS server is communicating with the AX clients on
Required? false
Position? 9
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-WsdlPort <String>
The TCP port that the AX 2012 AOS server is communicating with all WSDL consuming applications on
Required? false
Position? 10
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-NetTcpPort <String>
The TCP port that the AX 2012 AOS server is communicating with all NetTcp consuming applications on
Required? false
Position? 11
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-ConfigStorageLocation <String>
Parameter used to instruct where to store the configuration objects
The default value is "User" and this will store all configuration for the active user
Valid options are:
"User"
"System"
"System" will store the configuration so all users can access the configuration objects
Required? false
Position? named
Default value User
Accept pipeline input? false
Accept wildcard characters? false
-Temporary [<SwitchParameter>]
Instruct the cmdlet to only temporarily override the persisted settings in the configuration storage
Required? false
Position? named
Default value False
Accept pipeline input? false
Accept wildcard characters? false
-Clear [<SwitchParameter>]
Instruct the cmdlet to clear out all the stored configuration values
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
Author: M??????tz Jensen (@Splaxi)
-------------------------- EXAMPLE 1 --------------------------
PS C:\\>Get-AxAosInstance | Select-Object -First 1 | Set-AxActiveAosConfig
This will get all the AX 2012 AOS instances from the local machine and only select the first output.
The output from the first AOS instance is saved into the configuration store.
-------------------------- EXAMPLE 2 --------------------------
PS C:\\>Set-AxActiveAosConfig -ComputerName AX2012PROD -DatabaseServer SQLSERVER -DatabaseName AX2012R3_PROD
-ModelstoreDatabase AX2012R3_PROD_model -AosPort 2712
This will update the active AOS configuration store settings.
The computer name will be registered to: AX2012PROD
The database server will be registered to: SQLSERVER
The database name will be registered to: AX2012R3_PROD
The model store database will be registered to: AX2012R3_PROD_model
The AOS port will be registered to: 2712
-------------------------- EXAMPLE 3 --------------------------
PS C:\\>Set-AxActiveAosConfig -Clear
This will clear out all the stored configuration values.
It updates all the internal configuration variables, so all aos default values across the module will be empty.
RELATED LINKS
SYNOPSIS
Set the active AX 2012 AOS configuration
SYNTAX
Set-AxActiveAosConfig [[-ComputerName] <String[]>] [[-BinDirectory] <String>] [[-InstanceNumber] <String>]
[[-InstanceName] <String>] [[-DatabaseServer] <String>] [[-DatabaseName] <String>] [[-ModelstoreDatabase]
<String>] [[-AosPort] <String>] [[-WsdlPort] <String>] [[-NetTcpPort] <String>] [-ConfigStorageLocation <String>]
[-Temporary] [-Clear] [<CommonParameters>]
DESCRIPTION
Set the active AX 2012 AOS details and store it into the configuration storage
PARAMETERS
-ComputerName <String[]>
The name of the computer / server that AOS resides on
Required? false
Position? 2
Default value @($env:computername)
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-BinDirectory <String>
The full path to the bin directory where the AOS instance is physical installed
Required? false
Position? 3
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-InstanceNumber <String>
The 2 digit ([0-9][0-9]) number that the AOS instance has on the server
Required? false
Position? 4
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-InstanceName <String>
The instance name the AOS server is registered with
Required? false
Position? 5
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-DatabaseServer <String>
The name of the server running SQL Server
Required? false
Position? 6
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-DatabaseName <String>
The name of the AX 2012 business data database
Required? false
Position? 7
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-ModelstoreDatabase <String>
The name of the AX 2012 modelstore database
Required? false
Position? 8
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-AosPort <String>
The TCP port that the AX 2012 AOS server is communicating with the AX clients on
Required? false
Position? 9
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-WsdlPort <String>
The TCP port that the AX 2012 AOS server is communicating with all WSDL consuming applications on
Required? false
Position? 10
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-NetTcpPort <String>
The TCP port that the AX 2012 AOS server is communicating with all NetTcp consuming applications on
Required? false
Position? 11
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-ConfigStorageLocation <String>
Parameter used to instruct where to store the configuration objects
The default value is "User" and this will store all configuration for the active user
Valid options are:
"User"
"System"
"System" will store the configuration so all users can access the configuration objects
Required? false
Position? named
Default value User
Accept pipeline input? false
Accept wildcard characters? false
-Temporary [<SwitchParameter>]
Instruct the cmdlet to only temporarily override the persisted settings in the configuration storage
Required? false
Position? named
Default value False
Accept pipeline input? false
Accept wildcard characters? false
-Clear [<SwitchParameter>]
Instruct the cmdlet to clear out all the stored configuration values
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
Author: M??????tz Jensen (@Splaxi)
-------------------------- EXAMPLE 1 --------------------------
PS C:\\>Get-AxAosInstance | Select-Object -First 1 | Set-AxActiveAosConfig
This will get all the AX 2012 AOS instances from the local machine and only select the first output.
The output from the first AOS instance is saved into the configuration store.
-------------------------- EXAMPLE 2 --------------------------
PS C:\\>Set-AxActiveAosConfig -ComputerName AX2012PROD -DatabaseServer SQLSERVER -DatabaseName AX2012R3_PROD
-ModelstoreDatabase AX2012R3_PROD_model -AosPort 2712
This will update the active AOS configuration store settings.
The computer name will be registered to: AX2012PROD
The database server will be registered to: SQLSERVER
The database name will be registered to: AX2012R3_PROD
The model store database will be registered to: AX2012R3_PROD_model
The AOS port will be registered to: 2712
-------------------------- EXAMPLE 3 --------------------------
PS C:\\>Set-AxActiveAosConfig -Clear
This will clear out all the stored configuration values.
It updates all the internal configuration variables, so all aos default values across the module will be empty.
RELATED LINKS