Test-MbamWebApplication

Aggiornamento: agosto 2015

Si applica a: Microsoft BitLocker Administration and Monitoring 2.5, Microsoft BitLocker Administration and Monitoring 2.5 SP1

Test-MbamWebApplication

Checks server prerequisites and validates parameter values for a web application feature.

Sintassi

Parameter Set: ParameterSetAdministrationPortal
Test-MbamWebApplication -AdministrationPortal -AdvancedHelpdeskAccessGroup <String> -HelpdeskAccessGroup <String> -ReportsReadOnlyAccessGroup <String> -ReportUrl <Uri> [-Certificate <X509Certificate2> ] [-CMIntegrationMode] [-ComplianceAndAuditDBConnectionString <String> ] [-Detailed] [-HostName <String> ] [-InstallationPath <String> ] [-Port <Int32> ] [-RecoveryDBConnectionString <String> ] [-VirtualDirectory <String> ] [-WebServiceApplicationPoolCredential <PSCredential> ] [ <CommonParameters>]

Parameter Set: ParameterSetAgentService
Test-MbamWebApplication -AgentService [-Certificate <X509Certificate2> ] [-CMIntegrationMode] [-ComplianceAndAuditDBConnectionString <String> ] [-DataMigrationAccessGroup <System.String> ] [-Detailed] [-HostName <String> ] [-InstallationPath <String> ] [-Port <Int32> ] [-RecoveryDBConnectionString <String> ] [-TpmLockoutAutoReset] [-WebServiceApplicationPoolCredential <PSCredential> ] [ <CommonParameters>]

Parameter Set: ParameterSetSelfServicePortal
Test-MbamWebApplication -SelfServicePortal [-Certificate <X509Certificate2> ] [-CompanyName <System.String> ] [-ComplianceAndAuditDBConnectionString <String> ] [-Detailed] [-HelpdeskUrl <System.Uri> ] [-HelpdeskUrlText <System.String> ] [-HostName <String> ] [-InstallationPath <String> ] [-NoticeTextPath <System.String> ] [-Port <Int32> ] [-RecoveryDBConnectionString <String> ] [-VirtualDirectory <String> ] [-WebServiceApplicationPoolCredential <PSCredential> ] [ <CommonParameters>]




Descrizione dettagliata

The Test-MbamWebApplication cmdlet checks server prerequisites and validates parameter values for a Microsoft BitLocker Administration and Monitoring (MBAM) web application feature. The cmdlet validates the current computer for one of the following web applications:

-- Administration and Monitoring Website
-- Agent Services
-- Self-Service Portal

Parametri

-AdministrationPortal

Indicates that this cmdlet acts on the Administration and Monitoring Website web application.


Alias

none

Obbligatorio?

true

Posizione?

named

Valore predefinito

none

Accetta input da pipeline?

false

Accetta caratteri jolly?

false

-AdvancedHelpdeskAccessGroup<String>

Specifies a domain user group. This group has permissions for all areas of the Administration and Monitoring Website web application, except for reports.


Alias

AdvancedHelpdeskGroup

Obbligatorio?

true

Posizione?

named

Valore predefinito

none

Accetta input da pipeline?

True (ByPropertyName)

Accetta caratteri jolly?

false

-AgentService

Indicates that this cmdlet acts on the Agent Services web application.


Alias

none

Obbligatorio?

true

Posizione?

named

Valore predefinito

none

Accetta input da pipeline?

false

Accetta caratteri jolly?

false

-Certificate<X509Certificate2>

Specifies the certificate to use for encrypted web communications. If you do not specify a certificate, web communications are not encrypted.


Alias

none

Obbligatorio?

false

Posizione?

named

Valore predefinito

none

Accetta input da pipeline?

True (ByValue, ByPropertyName)

Accetta caratteri jolly?

false

-CMIntegrationMode

Indicates that all reports, except the Recovery Audit Report, are integrated into Microsoft System Center Configuration Manager. If you enable the System Center Configuration Manager Integration feature, specify this parameter.


Alias

CMMode

Obbligatorio?

false

Posizione?

named

Valore predefinito

none

Accetta input da pipeline?

false

Accetta caratteri jolly?

false

-CompanyName<System.String>

Specifies the company name associated with the web application.


Alias

none

Obbligatorio?

false

Posizione?

named

Valore predefinito

none

Accetta input da pipeline?

true(ByPropertyName)

Accetta caratteri jolly?

false

-ComplianceAndAuditDBConnectionString<String>

Specifies a connection string. The web application uses the string that this parameter specifies to connect to the Compliance and Audit Database feature. The connection string must contain values for the Integrated Security and Initial Catalog fields.

All of the web applications connect to the Compliance and Audit Database by using the same connection string.


Alias

ComplianceDB

Obbligatorio?

false

Posizione?

named

Valore predefinito

none

Accetta input da pipeline?

True (ByPropertyName)

Accetta caratteri jolly?

false

-DataMigrationAccessGroup<System.String>

Specifies the domain user group that is authorized to migrate Recovery information to MBAM server.


Alias

DataMigrationGroup

Obbligatorio?

false

Posizione?

named

Valore predefinito

none

Accetta input da pipeline?

true(ByPropertyName)

Accetta caratteri jolly?

false

-Detailed

Indicates that the cmdlet displays detailed information about the prerequisite check and parameter validation failures.


Alias

none

Obbligatorio?

false

Posizione?

named

Valore predefinito

none

Accetta input da pipeline?

false

Accetta caratteri jolly?

false

-HelpdeskAccessGroup<String>

Specifies the domain user group that has permissions for the Manage TPM and Drive Recovery areas of the Administration and Monitoring Website web application.


Alias

HelpdeskGroup

Obbligatorio?

true

Posizione?

named

Valore predefinito

none

Accetta input da pipeline?

True (ByPropertyName)

Accetta caratteri jolly?

false

-HelpdeskUrl<System.Uri>

Specifies the URL for the MBAM help desk site.


Alias

none

Obbligatorio?

false

Posizione?

named

Valore predefinito

none

Accetta input da pipeline?

true(ByPropertyName)

Accetta caratteri jolly?

false

-HelpdeskUrlText<System.String>

Specifies the helpdesk link text that will be displayed on the self-service portal.


Alias

none

Obbligatorio?

false

Posizione?

named

Valore predefinito

none

Accetta input da pipeline?

true(ByPropertyName)

Accetta caratteri jolly?

false

-HostName<String>

Specifies a host name. If you do not specify a host name, the cmdlet uses the fully qualified host name of the local computer. Ensure that you specify the same host name for all of the web applications.


Alias

none

Obbligatorio?

false

Posizione?

named

Valore predefinito

none

Accetta input da pipeline?

True (ByPropertyName)

Accetta caratteri jolly?

false

-InstallationPath<String>

Specifies the installation path of the web application. The installation process creates a folder named Microsoft BitLocker Management Solution in the location that this parameter specifies. If you do not specify a path, the cmdlet uses <IIS inetpub path>. Specify the same installation path for all of the web applications.


Alias

none

Obbligatorio?

false

Posizione?

named

Valore predefinito

none

Accetta input da pipeline?

True (ByPropertyName)

Accetta caratteri jolly?

false

-NoticeTextPath<System.String>

Specifies the absolute path to the text file (.txt) that contains the notice text.


Alias

none

Obbligatorio?

false

Posizione?

named

Valore predefinito

none

Accetta input da pipeline?

true(ByPropertyName)

Accetta caratteri jolly?

false

-Port<Int32>

Specifies the web service port. If you do not specify a port, unencrypted communications use port 80, and encrypted communications use port 443. You need to specify the same value for all of the web applications.

You must configure your firewall to allow communication through the ports for the Self-Service Portal and the Administration and Monitoring Website web applications.


Alias

none

Obbligatorio?

false

Posizione?

named

Valore predefinito

none

Accetta input da pipeline?

True (ByPropertyName)

Accetta caratteri jolly?

false

-RecoveryDBConnectionString<String>

Specifies a connection string. The web application uses the string that this parameter specifies to connect to the Recovery Database. The connection string must contain values for the Integrated Security and Initial Catalog fields. You need to use the same connection string to ensure that all of the web applications connect to the Recovery Database.


Alias

RecoveryDB

Obbligatorio?

false

Posizione?

named

Valore predefinito

none

Accetta input da pipeline?

True (ByPropertyName)

Accetta caratteri jolly?

false

-ReportsReadOnlyAccessGroup<String>

Specifies a domain user group. You need to specify a group that has read permissions for the Reports area of the Administration and Monitoring Website web application.


Alias

ReportsGroup

Obbligatorio?

true

Posizione?

named

Valore predefinito

none

Accetta input da pipeline?

True (ByPropertyName)

Accetta caratteri jolly?

false

-ReportUrl<Uri>

Specifies the URL for the reports that the Microsoft SQL Server Reporting Services instance publishes.


Alias

none

Obbligatorio?

true

Posizione?

named

Valore predefinito

none

Accetta input da pipeline?

True (ByPropertyName)

Accetta caratteri jolly?

false

-SelfServicePortal

Indicates that this cmdlet acts on the Self-Service Portal web application.


Alias

none

Obbligatorio?

true

Posizione?

named

Valore predefinito

none

Accetta input da pipeline?

false

Accetta caratteri jolly?

false

-TpmLockoutAutoReset

Indicates that Agent Services allows TPM lockout resets.


Alias

none

Obbligatorio?

false

Posizione?

named

Valore predefinito

none

Accetta input da pipeline?

true(ByPropertyName)

Accetta caratteri jolly?

false

-VirtualDirectory<String>

Specifies a virtual directory for the web application. If you do not specify a virtual directory, the cmdlet uses the value HelpDesk for Administration and Monitoring Website, or it uses the value SelfService for Self-Service Portal.


Alias

none

Obbligatorio?

false

Posizione?

named

Valore predefinito

none

Accetta input da pipeline?

false

Accetta caratteri jolly?

false

-WebServiceApplicationPoolCredential<PSCredential>

Specifies the domain user that the application pool for the web applications uses.

If you do not specify this parameter, the cmdlet uses the credentials that you previously specified for any enabled web application. All of the web applications use the same application pool credentials. If you specify credentials for web applications more than once, web applications use the most recent value.

Important: For improved security use an account that has limited user rights. Also, you need to configure the account so that the password never expires.


Alias

AppPoolCred

Obbligatorio?

false

Posizione?

named

Valore predefinito

none

Accetta input da pipeline?

True (ByPropertyName)

Accetta caratteri jolly?

false

<CommonParameters>

Questo cmdlet supporta i parametri comuni: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer e -OutVariable. Per altre informazioni, vedere   about_CommonParameters (http://go.microsoft.com/fwlink/p/?LinkID=113216).

Input

Il tipo di input è il tipo degli oggetti che è possibile reindirizzare al cmdlet.

Output

Il tipo di output corrisponde al tipo di oggetti generati dal cmdlet.

  • bool

Esempi

Example 1: Check prerequisites and validate parameters for Administration and Monitoring Website

This command checks the prerequisites and validates parameter values to enable the Administration and Monitoring Website web application on the current server. The command tests a configuration of the website that uses the Compliance and Audit Database and the Recovery Database present in the ContosoDatabaseServer and the reports present in the ContosoReportsServer.


PS C:\> Test-MbamWebApplication -AdministrationPortal -ComplianceAndAuditDBConnectionString "Integrated Security=SSPI;Data Source=ContosoDatabaseServer;Initial Catalog=MBAM Compliance Status" -RecoveryDBConnectionString "Integrated Security=SSPI;Data Source=ContosoDatabaseServer;Initial Catalog=MBAM Recovery and Hardware" -AdvancedHelpdeskAccessGroup "Contoso\AdvancedUserGroup" -HelpdeskAccessGroup "Contoso\StandardUserGroup" -ReportsReadOnlyAccessGroup "Contoso\ReportUserGroup" -ReportUrl "https://ContosoReportServer/ReportServer" -Port 443 -WebServiceApplicationPoolCredential (Get-Credential) -Certificate (dir cert:\LocalComputer\My\E2A7EA5533890D6567E40DFC46F53B3D31D6B689)

Example 2: Check prerequisites and validate parameters for Self-Service Portal

This command checks the prerequisites and validates parameter values to enable the Self-Service Portal web application on this server. The command checks the configuration of the Portal that uses the Compliance and Audit Database and the Recovery Database present in the ContosoDatabaseServer.


PS C:\> Test-MbamWebApplication -SelfServicePortal -ComplianceAndAuditDBConnectionString "Integrated Security=SSPI;Data Source=ContosoDatabaseServer;Initial Catalog=MBAM Compliance Status" -RecoveryDBConnectionString "Integrated Security=SSPI;Data Source=ContosoDatabaseServer;Initial Catalog=MBAM Recovery and Hardware" -Port 443 -WebServiceApplicationPoolCredential (Get-Credential) -Certificate (dir cert:\LocalComputer\My\E2A7EA5533890D6567E40DFC46F53B3D31D6B689) 

Example 3: Check prerequisites and validate parameters for Agent Services

This command checks the prerequisites and validates parameter values to enable the Agent Services feature on the current server. The cmdlets verify a configuration of services that uses the Compliance and Audit Database and the Recovery Database present in the ContosoDatabaseServer.


PS C:\> Test-MbamWebApplication -AgentService -ComplianceAndAuditDBConnectionString "Integrated Security=SSPI;Data Source=ContosoDatabaseServer;Initial Catalog=MBAM Compliance Status" -RecoveryDBConnectionString "Integrated Security=SSPI;Data Source=ContosoDatabaseServer;Initial Catalog=MBAM Recovery and Hardware" -Port 443 -WebServiceApplicationPoolCredential (Get-Credential) -Certificate (dir cert:\LocalComputer\My\E2A7EA5533890D6567E40DFC46F53B3D31D6B689) 

Example 4: View detailed information

This command checks the prerequisites and validates parameter values to enable the Administration and Monitoring Website on this server. The command specifies the Detailed parameter, and, therefore, displays detailed information.


PS C:\> Test-MbamWebApplication -AdministrationPortal -ComplianceAndAuditDBConnectionString "Integrated Security=SSPI;Data Source=ContosoDatabaseServer;Initial Catalog=MBAM Compliance Status" -RecoveryDBConnectionString "Integrated Security=SSPI;Data Source=ContosoDatabaseServer;Initial Catalog=MBAM Recovery and Hardware" -AdvancedHelpdeskAccessGroup "Contoso\AdvancedUserGroup" -HelpdeskAccessGroup "Contoso\StandardUserGroup" -ReportsReadOnlyAccessGroup "Contoso\ReportUserGroup" -ReportUrl "https://ContosoReportServer/ReportServer" -Port 443 -WebServiceApplicationPoolCredential (Get-Credential) -Certificate (dir cert:\LocalComputer\My\E2A7EA5533890D6567E40DFC46F53B3D31D6B689) -Detailed

Argomenti correlati

Aggiunte alla community

AGGIUNGI
Mostra: