Update-AzCdnEndpoint
Aktualisiert einen vorhandenen CDN-Endpunkt mit dem angegebenen Endpunktnamen unter dem angegebenen Abonnement, der Ressourcengruppe und dem Angegebenen Profil. Nach dem Erstellen eines Endpunkts können nur Tags aktualisiert werden. Um Ursprünge zu aktualisieren, verwenden Sie den Update Origin-Vorgang. Verwenden Sie den Vorgang "Origin aktualisieren", um Die Ursprungsgruppen zu aktualisieren. Verwenden Sie den Vorgang "Benutzerdefinierte Domäne aktualisieren", um benutzerdefinierte Domänen zu aktualisieren.
Syntax
Update-AzCdnEndpoint
-Name <String>
-ProfileName <String>
-ResourceGroupName <String>
[-SubscriptionId <String>]
[-ContentTypesToCompress <String[]>]
[-DefaultOriginGroupId <String>]
[-DeliveryPolicyDescription <String>]
[-DeliveryPolicyRule <IDeliveryRule[]>]
[-GeoFilter <IGeoFilter[]>]
[-IsCompressionEnabled]
[-IsHttpAllowed]
[-IsHttpsAllowed]
[-OptimizationType <OptimizationType>]
[-OriginHostHeader <String>]
[-OriginPath <String>]
[-ProbePath <String>]
[-QueryStringCachingBehavior <QueryStringCachingBehavior>]
[-Tag <Hashtable>]
[-UrlSigningKey <IUrlSigningKey[]>]
[-WebApplicationFirewallPolicyLinkId <String>]
[-DefaultProfile <PSObject>]
[-AsJob]
[-NoWait]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Update-AzCdnEndpoint
-InputObject <ICdnIdentity>
[-ContentTypesToCompress <String[]>]
[-DefaultOriginGroupId <String>]
[-DeliveryPolicyDescription <String>]
[-DeliveryPolicyRule <IDeliveryRule[]>]
[-GeoFilter <IGeoFilter[]>]
[-IsCompressionEnabled]
[-IsHttpAllowed]
[-IsHttpsAllowed]
[-OptimizationType <OptimizationType>]
[-OriginHostHeader <String>]
[-OriginPath <String>]
[-ProbePath <String>]
[-QueryStringCachingBehavior <QueryStringCachingBehavior>]
[-Tag <Hashtable>]
[-UrlSigningKey <IUrlSigningKey[]>]
[-WebApplicationFirewallPolicyLinkId <String>]
[-DefaultProfile <PSObject>]
[-AsJob]
[-NoWait]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Beschreibung
Aktualisiert einen vorhandenen CDN-Endpunkt mit dem angegebenen Endpunktnamen unter dem angegebenen Abonnement, der Ressourcengruppe und dem Angegebenen Profil. Nach dem Erstellen eines Endpunkts können nur Tags aktualisiert werden. Um Ursprünge zu aktualisieren, verwenden Sie den Update Origin-Vorgang. Verwenden Sie den Vorgang "Origin aktualisieren", um Die Ursprungsgruppen zu aktualisieren. Verwenden Sie den Vorgang "Benutzerdefinierte Domäne aktualisieren", um benutzerdefinierte Domänen zu aktualisieren.
Beispiele
Beispiel 1: Aktualisieren eines AzureCDN-Endpunkts unter dem AzureCDN-Profil
$tags = @{
Tag1 = 11
Tag2 = 22
}
Update-AzCdnEndpoint -ResourceGroupName testps-rg-da16jm -ProfileName cdn001 -Name endptest001 -Tag $tags -DefaultOriginGroupId $originGroup.Id
Location Name ResourceGroupName
-------- ---- -----------------
WestUs endptest001 testps-rg-da16jm
Aktualisieren eines AzureCDN-Endpunkts unter dem AzureCDN-Profil
Beispiel 2: Aktualisieren eines AzureCDN-Endpunkts unter dem AzureCDN-Profil über Identität
$tags = @{
Tag1 = 11
Tag2 = 22
}
Get-AzCdnEndpoint -ResourceGroupName testps-rg-da16jm -ProfileName cdn001 -Name endptest001 | Update-AzCdnEndpoint -Tag $tags -DefaultOriginGroupId $originGroup.Id
Location Name ResourceGroupName
-------- ---- -----------------
WestUs endptest001 testps-rg-da16jm
Aktualisieren eines AzureCDN-Endpunkts unter dem AzureCDN-Profil über Identität
Beispiel 3: Aktualisieren eines AzureCDN-Endpunkts unter dem AzureCDN-Profil, aktivierte Inhaltskomprimierung
Update-AzCdnEndpoint -Name cdntestcert -ProfileName classicCDNtest -ResourceGroupName yaoshitest -IsCompressionEnabled:$true
Location Name ResourceGroupName
-------- ---- -----------------
WestUs endptest001 testps-rg-da16jm
Aktualisieren eines AzureCDN-Endpunkts unter dem AzureCDN-Profil, aktivierte Inhaltskomprimierung
Parameter
-AsJob
Ausführen des Befehls als Auftrag
Typ: | SwitchParameter |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-Confirm
Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.
Typ: | SwitchParameter |
Aliase: | cf |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-ContentTypesToCompress
Liste der Inhaltstypen, für die die Komprimierung gilt. Der Wert sollte ein gültiger MIME-Typ sein.
Typ: | String[] |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-DefaultOriginGroupId
Ressourcen-ID.
Typ: | String |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-DefaultProfile
Der Parameter DefaultProfile ist nicht funktionsfähig. Verwenden Sie den Parameter "SubscriptionId", wenn sie verfügbar ist, wenn Sie das Cmdlet für ein anderes Abonnement ausführen.
Typ: | PSObject |
Aliase: | AzureRMContext, AzureCredential |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-DeliveryPolicyDescription
Benutzerfreundliche Beschreibung der Richtlinie.
Typ: | String |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-DeliveryPolicyRule
Eine Liste der Übermittlungsregeln. Informationen zum Erstellen finden Sie im Abschnitt "NOTES" für DELIVERYPOLICYRULE-Eigenschaften und erstellen eine Hashtabelle.
Typ: | IDeliveryRule[] |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-GeoFilter
Liste der Regeln, die den geografischen Zugriff des Benutzers innerhalb eines CDN-Endpunkts definieren. Jeder Geofilter definiert eine Zugriffsregel für einen angegebenen Pfad oder Inhalt, z. B. block APAC für pfad /pictures/ To construct, see NOTES section for GEOFILTER properties and create a hash table.
Typ: | IGeoFilter[] |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-InputObject
Identity Parameter To construct, see NOTES section for INPUTOBJECT properties and create a hash table.
Typ: | ICdnIdentity |
Position: | Named |
Standardwert: | None |
Erforderlich: | True |
Pipelineeingabe akzeptieren: | True |
Platzhalterzeichen akzeptieren: | False |
-IsCompressionEnabled
Gibt an, ob die Inhaltskomprimierung im CDN aktiviert ist. Der Standardwert ist "false". Wenn die Komprimierung aktiviert ist, werden Inhalte als komprimiert bereitgestellt, wenn der Benutzer eine komprimierte Version anfordert. Der Inhalt wird nicht auf CDN komprimiert, wenn angeforderter Inhalt kleiner als 1 Byte oder größer als 1 MB ist.
Typ: | SwitchParameter |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-IsHttpAllowed
Gibt an, ob HTTP-Datenverkehr auf dem Endpunkt zulässig ist. Der Standardwert ist true. Mindestens ein Protokoll (HTTP oder HTTPS) muss zulässig sein.
Typ: | SwitchParameter |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-IsHttpsAllowed
Gibt an, ob HTTPS-Datenverkehr auf dem Endpunkt zulässig ist. Der Standardwert ist true. Mindestens ein Protokoll (HTTP oder HTTPS) muss zulässig sein.
Typ: | SwitchParameter |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-Name
Name des Endpunkts unter dem Profil, das global eindeutig ist.
Typ: | String |
Aliase: | EndpointName |
Position: | Named |
Standardwert: | None |
Erforderlich: | True |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-NoWait
Asynchrones Ausführen des Befehls
Typ: | SwitchParameter |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-OptimizationType
Gibt an, für welches Szenario der Kunde diesen CDN-Endpunkt optimieren möchte, z. B. "Herunterladen", "Mediendienste". Mit diesen Informationen kann CDN szenariogesteuerte Optimierung anwenden.
Typ: | OptimizationType |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-OriginHostHeader
Der Hostheaderwert, der mit jeder Anforderung an den Ursprung gesendet wird. Diese Eigenschaft bei Endpunkt ist nur zulässig, wenn der Endpunkt einen einzelnen Ursprung verwendet und von derselben Eigenschaft außer Kraft gesetzt werden kann, die am Ursprung angegeben ist. Wenn Sie diesen Wert leer lassen, bestimmt der Anforderungshost diesen Wert. Azure CDN-Ursprünge, z. B. Web Apps, Blob Storage und Cloud Services, erfordern diesen Hostheaderwert, um standardmäßig mit dem Ursprungshostnamen übereinzugleichen.
Typ: | String |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-OriginPath
Ein Verzeichnispfad auf dem Ursprung, von dem CDN zum Abrufen von Inhalten verwendet werden kann, z. B. contoso.cloudapp.net/originpath.
Typ: | String |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-ProbePath
Pfad zu einer Datei, die auf dem Ursprung gehostet wird, wodurch die Übermittlung des dynamischen Inhalts beschleunigt und die optimalen Routen für das CDN berechnet wird. Dies ist relativ zum Ursprungspfad. Diese Eigenschaft ist nur bei Verwendung eines einzelnen Ursprungs relevant.
Typ: | String |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-ProfileName
Name des CDN-Profils, das innerhalb der Ressourcengruppe eindeutig ist.
Typ: | String |
Position: | Named |
Standardwert: | None |
Erforderlich: | True |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-QueryStringCachingBehavior
Definiert, wie CDN Anforderungen zwischenspeichert, die Abfragezeichenfolgen enthalten. Sie können alle Abfragezeichenfolgen beim Zwischenspeichern ignorieren, Zwischenspeichern umgehen, um zu verhindern, dass Anforderungen, die Abfragezeichenfolgen enthalten, zwischengespeichert werden, oder jede Anforderung mit einer eindeutigen URL zwischenspeichern.
Typ: | QueryStringCachingBehavior |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-ResourceGroupName
Name der Ressourcengruppe innerhalb des Azure-Abonnements.
Typ: | String |
Position: | Named |
Standardwert: | None |
Erforderlich: | True |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-SubscriptionId
Azure-Abonnement-ID.
Typ: | String |
Position: | Named |
Standardwert: | (Get-AzContext).Subscription.Id |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-Tag
Endpunkttags.
Typ: | Hashtable |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-UrlSigningKey
Liste der Schlüssel, die zum Überprüfen der signierten URL-Hashes verwendet werden. Informationen zum Erstellen finden Sie im ABSCHNITT "NOTES" für URLSIGNINGKEY-Eigenschaften und erstellen eine Hashtabelle.
Typ: | IUrlSigningKey[] |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-WebApplicationFirewallPolicyLinkId
Ressourcen-ID.
Typ: | String |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-WhatIf
Zeigt, was passiert, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.
Typ: | SwitchParameter |
Aliase: | wi |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
Eingaben
Ausgaben
Azure PowerShell