functions/get-d365environment.ps1
|
<# .SYNOPSIS Cmdlet to get the current status for the different services in a Dynamics 365 Finance & Operations environment .DESCRIPTION List status for all relevant services that is running in a D365FO environment .PARAMETER ComputerName An array of computers that you want to query for the services status on. .PARAMETER All Set when you want to query all relevant services Includes: Aos Batch Financial Reporter DMF .PARAMETER Aos Instruct the cmdlet to query the AOS (IIS) service .PARAMETER Batch Instruct the cmdlet query the batch service .PARAMETER FinancialReporter Instruct the cmdlet query the financial reporter (Management Reporter 2012) .PARAMETER DMF Instruct the cmdlet query the DMF service .PARAMETER OnlyStartTypeAutomatic Instruct the cmdlet to filter out services that are set to manual start or disabled .PARAMETER OutputServiceDetailsOnly Instruct the cmdlet to exclude the server name from the output .EXAMPLE PS C:\> Get-D365Environment Will query all D365FO service on the machine. .EXAMPLE PS C:\> Get-D365Environment -All Will query all D365FO service on the machine. .EXAMPLE PS C:\> Get-D365Environment -OnlyStartTypeAutomatic Will query all D365FO service on the machine. It will filter out all services that are either configured as manual or disabled. .EXAMPLE PS C:\> Get-D365Environment -ComputerName "TEST-SB-AOS1","TEST-SB-AOS2","TEST-SB-BI1" -All Will query all D365FO service on the different machines. .EXAMPLE PS C:\> Get-D365Environment -Aos -Batch Will query the Aos & Batch services on the machine. .EXAMPLE PS C:\> Get-D365Environment -FinancialReporter -DMF Will query the FinancialReporter & DMF services on the machine. .EXAMPLE PS C:\> Get-D365Environment -OutputServiceDetailsOnly Will query all D365FO service on the machine. Will omit the servername from the output. .EXAMPLE PS C:\> Get-D365Environment -FinancialReporter | Set-Service -StartupType Manual This will configure the Financial Reporter services to be start type manual. .NOTES Tags: Environment, Service, Services, Aos, Batch, Servicing Author: Mötz Jensen (@Splaxi) #> function Get-D365Environment { [Diagnostics.CodeAnalysis.SuppressMessageAttribute("PSAvoidDefaultValueSwitchParameter", "")] [CmdletBinding(DefaultParameterSetName = 'Default')] param ( [Parameter(Mandatory = $false, ParameterSetName = 'Default', Position = 1 )] [Parameter(Mandatory = $false, ParameterSetName = 'Specific', Position = 1 )] [string[]] $ComputerName = @($env:computername), [Parameter(Mandatory = $false, ParameterSetName = 'Default')] [switch] $All = $true, [Parameter(Mandatory = $false, ParameterSetName = 'Specific')] [switch] $Aos, [Parameter(Mandatory = $false, ParameterSetName = 'Specific')] [switch] $Batch, [Parameter(Mandatory = $false, ParameterSetName = 'Specific')] [switch] $FinancialReporter, [Parameter(Mandatory = $false, ParameterSetName = 'Specific')] [switch] $DMF, [switch] $OnlyStartTypeAutomatic, [switch] $OutputServiceDetailsOnly ) if ($PSCmdlet.ParameterSetName -eq "Specific") { $All = $false } if ( (-not ($All)) -and (-not ($Aos)) -and (-not ($Batch)) -and (-not ($FinancialReporter)) -and (-not ($DMF))) { Write-PSFMessage -Level Host -Message "You have to use at least one switch when running this cmdlet. Please run the cmdlet again." Stop-PSFFunction -Message "Stopping because of missing parameters" return } $Params = Get-DeepClone $PSBoundParameters if($Params.ContainsKey("ComputerName")){$null = $Params.Remove("ComputerName")} if($Params.ContainsKey("OutputServiceDetailsOnly")){$null = $Params.Remove("OutputServiceDetailsOnly")} if($Params.ContainsKey("OnlyStartTypeAutomatic")){$null = $Params.Remove("OnlyStartTypeAutomatic")} $Services = Get-ServiceList @Params $Results = foreach ($server in $ComputerName) { Get-Service -ComputerName $server -Name $Services -ErrorAction SilentlyContinue | Select-Object @{Name = "Server"; Expression = {$Server}}, Name, Status, StartType, DisplayName } $outputTypeName = "D365FO.TOOLS.Environment.Service" if($OutputServiceDetailsOnly) { $outputTypeName = "D365FO.TOOLS.Environment.Service.Minimal" } if($OnlyStartTypeAutomatic){ $Results = $Results | Where-Object StartType -eq "Automatic" } $Results | Select-PSFObject -TypeName $outputTypeName Server, DisplayName, Status, StartType, Name } |