New-AzApplicationInsightsWebTest

Modul:

Az.ApplicationInsights

Erstellt oder aktualisiert eine Application Insights-Webtestdefinition.

Syntax

New-AzApplicationInsightsWebTest
   -Name <String>
   -ResourceGroupName <String>
   [-SubscriptionId <String>]
   -Location <String>
   [-ContentIgnoreCase]
   [-ContentMatch <String>]
   [-ContentPassIfTextFound]
   [-Description <String>]
   [-Enabled]
   [-Frequency <Int32>]
   [-GeoLocation <IWebTestGeolocation[]>]
   [-Kind <WebTestKindEnum>]
   [-RequestBody <String>]
   [-RequestFollowRedirect]
   [-RequestHeader <IHeaderField[]>]
   [-RequestHttpVerb <String>]
   [-RequestParseDependent]
   [-RequestUrl <String>]
   [-RetryEnabled]
   [-RuleExpectedHttpStatusCode <Int32>]
   [-RuleIgnoreHttpsStatusCode]
   [-RuleSslCertRemainingLifetimeCheck <Int32>]
   [-RuleSslCheck]
   [-Tag <Hashtable>]
   [-TestName <String>]
   [-Timeout <Int32>]
   [-DefaultProfile <PSObject>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzApplicationInsightsWebTest
   -Name <String>
   -ResourceGroupName <String>
   [-SubscriptionId <String>]
   -Location <String>
   [-ContentMatch <String>]
   [-Description <String>]
   [-Enabled]
   [-Frequency <Int32>]
   [-GeoLocation <IWebTestGeolocation[]>]
   [-Kind <WebTestKindEnum>]
   [-RequestParseDependent]
   [-RequestUrl <String>]
   [-RetryEnabled]
   [-RuleExpectedHttpStatusCode <Int32>]
   [-Tag <Hashtable>]
   [-TestName <String>]
   [-Timeout <Int32>]
   [-Configuration <String>]
   [-DefaultProfile <PSObject>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Beschreibung

Erstellt oder aktualisiert eine Application Insights-Webtestdefinition.

Beispiele

Beispiel 1: Erstellt oder aktualisiert eine Standardart des Application Insights-Webtests.

$geoLocation = @()
$geoLocation += New-AzApplicationInsightsWebTestGeolocationObject -Location "emea-nl-ams-azr"
$geoLocation += New-AzApplicationInsightsWebTestGeolocationObject -Location "us-ca-sjc-azr"
New-AzApplicationInsightsWebTest -ResourceGroupName azpwsh-rg-test -Name standard-pwsh01 -Location 'westus2' `
-Tag @{"hidden-link:/subscriptions/xxxxxxxxxx-xxxx-xxxxx-xxxxxxxxxxxx/resourceGroups/azpwsh-rg-test/providers/microsoft.insights/components/appinsights-portal01" = "Resource"} `
-RequestUrl "https://www.bing.com" -RequestHttpVerb "GET" -TestName 'standard-pwsh01' `
-RuleExpectedHttpStatusCode 200 -Frequency 300 -Enabled -Timeout 120 -Kind 'standard' -RetryEnabled -GeoLocation $geoLocation

Name            Location WebTestKind ResourceGroupName  Enabled
----            -------- ----------- -----------------  -------
standard-pwsh01 westus2  standard    azpwsh-rg-test     True

Mit diesem Befehl wird eine Standardart des Application Insights-Webtests erstellt oder aktualisiert.

Wir geben ausgeblendeten Link in den Tag Parameter ein, um WebTest und Application Insights zuzuordnen.

Beispiel 2: Erstellt oder aktualisiert eine Standardart des Application Insights-Webtests im deaktivierten Zustand.

$geoLocation = @()
$geoLocation += New-AzApplicationInsightsWebTestGeolocationObject -Location "emea-nl-ams-azr"
$geoLocation += New-AzApplicationInsightsWebTestGeolocationObject -Location "us-ca-sjc-azr"
New-AzApplicationInsightsWebTest -ResourceGroupName azpwsh-rg-test -Name standard-pwsh01 -Location 'westus2' `
-Tag @{"hidden-link:/subscriptions/xxxxxxxxxx-xxxx-xxxxx-xxxxxxxxxxxx/resourceGroups/azpwsh-rg-test/providers/microsoft.insights/components/appinsights-portal01" = "Resource"} `
-RequestUrl "https://www.bing.com" -RequestHttpVerb "GET" -TestName 'standard-pwsh01' `
-RuleExpectedHttpStatusCode 200 -Frequency 300 -Enabled:$false -Timeout 120 -Kind 'standard' -RetryEnabled -GeoLocation $geoLocation

Name            Location WebTestKind ResourceGroupName  Enabled
----            -------- ----------- -----------------  -------
standard-pwsh01 westus2  standard    azpwsh-rg-test     False

Mit diesem Befehl wird eine Standardart des Application Insights-Webtests im deaktivierten Zustand erstellt oder aktualisiert.

Der Schalterparameter "-Enabled" muss explizit auf $false festgelegt werden, um den Test zu deaktivieren.

Beispiel 3: Erstellt oder aktualisiert eine Pingart des Application Insights-Webtests.

$geoLocation = @()
$geoLocation += New-AzApplicationInsightsWebTestGeolocationObject -Location "emea-nl-ams-azr"
$geoLocation += New-AzApplicationInsightsWebTestGeolocationObject -Location "us-ca-sjc-azr"
New-AzApplicationInsightsWebTest -ResourceGroupName azpwsh-rg-test -Name 'pingwebtest-pwsh01' -TestName 'pingwentest-pwsh01testname' -Location 'westus2' `
-Tag @{"hidden-link:/subscriptions/xxxxxxxxxx-xxxx-xxxxx-xxxxxxxxxxxx/resourceGroups/azpwsh-rg-test/providers/microsoft.insights/components/appinsights-portal01" = "Resource"} `
-GeoLocation $geoLocation -RetryEnabled -Enabled -Frequency 300 -Timeout 90 `
-Kind 'ping' -RequestUrl 'https://cn.bing.com' -RequestParseDependent -RuleExpectedHttpStatusCode 200 `
-ContentMatch "status"

Name               Location WebTestKind ResourceGroupName   Enabled
----               -------- ----------- -----------------   -------
pingwebtest-pwsh01 westus2  ping        azpwsh-rg-test      True

Mit diesem Befehl wird eine Pingart des Application Insights-Webtests erstellt oder aktualisiert.

Beispiel 4: Erstellt oder aktualisiert eine Pingart des Application Insights-Webtests mit benutzerdefinierter Konfiguration.

$geoLocation = @()
$geoLocation += New-AzApplicationInsightsWebTestGeolocationObject -Location "emea-nl-ams-azr"
$geoLocation += New-AzApplicationInsightsWebTestGeolocationObject -Location "us-ca-sjc-azr"
New-AzApplicationInsightsWebTest -ResourceGroupName azpwsh-rg-test -Name 'pingwebtest-pwsh01' -TestName 'pingwentest-pwsh01testname' -Location 'westus2' `
-Tag @{"hidden-link:/subscriptions/xxxxxxxxxx-xxxx-xxxxx-xxxxxxxxxxxx/resourceGroups/azpwsh-rg-test/providers/microsoft.insights/components/appinsights-portal01" = "Resource"} `
-GeoLocation $geoLocation -RetryEnabled -Enabled -Frequency 300 -Timeout 90 `
-Kind 'ping' `
-Configuration "<WebTest  Name=`"basic-portal03`"  Id=`"9407db10-5d84-487f-98a3-a1ee67bb98f0`"  Enabled=`"True`"  CssProjectStructure=`"`"  CssIteration=`"`"  Timeout=`"90`"  WorkItemIds=`"`"  xmlns=`"http://microsoft.com/schemas/VisualStudio/TeamTest/2010`"  Description=`"`"  CredentialUserName=`"`"  CredentialPassword=`"`"  PreAuthenticate=`"True`"  Proxy=`"default`"  StopOnError=`"False`"  RecordedResultFile=`"`"  ResultsLocale=`"`">
    <Items>
        <Request Method=`"GET`"  Guid=`"a2025e53-0702-d03e-f311-5774ec16893d`"  Version=`"1.1`"  Url=`"https://www.bing.com`"  ThinkTime=`"0`"  Timeout=`"90`"  ParseDependentRequests=`"True`"  FollowRedirects=`"True`"  RecordResult=`"True`"  Cache=`"False`"  ResponseTimeGoal=`"0`"  Encoding=`"utf-8`"  ExpectedHttpStatusCode=`"200`"  ExpectedResponseUrl=`"`"  ReportingName=`"`"  IgnoreHttpStatusCode=`"False`" />
    </Items>
    <ValidationRules>
        <ValidationRule  Classname=`"Microsoft.VisualStudio.TestTools.WebTesting.Rules.ValidationRuleFindText, Microsoft.VisualStudio.QualityTools.WebTestFramework, Version=10.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a`"  DisplayName=`"Find Text`"  Description=`"Verifies the existence of the specified text in the response.`"  Level=`"High`"  ExectuionOrder=`"BeforeDependents`">
            <RuleParameters>
            <RuleParameter Name=`"FindText`" Value=`"test content match`" />
            <RuleParameter Name=`"IgnoreCase`" Value=`"False`" />
            <RuleParameter Name=`"UseRegularExpression`" Value=`"False`" />
            <RuleParameter Name=`"PassIfTextFound`" Value=`"True`" />
            </RuleParameters>
        </ValidationRule>
    </ValidationRules>
</WebTest>"

Name               Location WebTestKind ResourceGroupName   Enabled
----               -------- ----------- -----------------   -------
pingwebtest-pwsh01 westus2  ping        azpwsh-rg-test      True

Mit diesem Befehl wird eine Pingart des Application Insights-Webtests mit benutzerdefinierter Konfiguration erstellt oder aktualisiert.

Parameter

-Configuration

Die XML-Spezifikation eines WebTest-Elements, das für eine Anwendung ausgeführt werden soll.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ContentIgnoreCase

Wenn dieser Wert festgelegt ist, wird die Groß-/Kleinschreibung der ContentMatch-Überprüfung nicht beachtet.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ContentMatch

Inhalt, der in der Rückgabe von WebTest gesucht werden soll. Darf nicht null oder leer sein.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ContentPassIfTextFound

Wenn true, wird die Überprüfung übergeben, wenn eine Übereinstimmung für die ContentMatch-Zeichenfolge vorhanden ist. Bei "False" schlägt die Überprüfung fehl, wenn eine Übereinstimmung vorhanden ist.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DefaultProfile

Anmeldeinformationen, Konto, Mandant und Abonnement für die Kommunikation mit Azure

Type:	PSObject
Aliases:	AzureRMContext, AzureCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Description

Benutzerdefinierte Beschreibung für diesen WebTest.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Enabled

Wird der Test aktiv überwacht.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Frequency

Intervall in Sekunden zwischen Testläufen für diesen WebTest. Der Standardwert ist 300.

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-GeoLocation

Eine Liste, in der die Tests physisch ausgeführt werden sollen, um eine globale Abdeckung für die Barrierefreiheit Ihrer Anwendung zu ermöglichen. Informationen zum Erstellen finden Sie im Abschnitt "NOTES" für GEOLOCATION-Eigenschaften und erstellen eine Hashtabelle.

Type:	IWebTestGeolocation[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Kind

Dies ist die Art des Webtests, die gültige Auswahlmöglichkeiten sind Ping, Mehrschritte und Standard.

Type:	WebTestKindEnum
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Location

Ressourcenspeicherort

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Name

Der Name der Application Insights WebTest-Ressource.

Type:	String
Aliases:	WebTestName
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-RequestBody

Base64-codierter Zeichenfolgentext, der mit diesem Webtest gesendet werden soll.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-RequestFollowRedirect

Folgen Sie Umleitungen für diesen Webtest.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-RequestHeader

Liste der Kopfzeilen und deren Werte, die dem WebTest-Aufruf hinzugefügt werden sollen. Informationen zum Erstellen finden Sie im Abschnitt "NOTES" für REQUESTHEADER-Eigenschaften und erstellen eine Hashtabelle.

Type:	IHeaderField[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-RequestHttpVerb

Http-Verb, das für diesen Webtest verwendet werden soll.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-RequestParseDependent

Analysieren der abhängigen Anforderung für diesen WebTest.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-RequestUrl

Url-Speicherort, der getestet werden soll.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ResourceGroupName

Der Name der Ressourcengruppe. Für den Namen wird die Groß-/Kleinschreibung nicht beachtet.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-RetryEnabled

Fehler beim Zulassen von Wiederholungen, wenn dieser WebTest fehlschlägt.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-RuleExpectedHttpStatusCode

Überprüfen Sie, ob der WebTest den bereitgestellten HTTP-Statuscode zurückgibt.

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-RuleIgnoreHttpsStatusCode

Bei Festlegung ignoriert die Überprüfung den Statuscode.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-RuleSslCertRemainingLifetimeCheck

Eine Anzahl von Tagen, die noch einmal überprüft werden sollen Standard bevor das vorhandene SSL-Zertifikat abläuft. Der Wert muss positiv sein, und der SSLCheck muss auf "true" festgelegt werden.

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-RuleSslCheck

Überprüft, ob das SSL-Zertifikat noch gültig ist.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SubscriptionId

Hierbei handelt es sich um die ID des Zielabonnements.

Type:	String
Position:	Named
Default value:	(Get-AzContext).Subscription.Id
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Tag

Ressourcentags

Type:	Hashtable
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-TestName

Benutzerdefinierter Name, wenn dieser WebTest.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Timeout

Sekunden, bis dieser WebTest timeout und fehlschlägt. Standardwert: 30.

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Ausgaben

IWebTest