Set-AzVMProxyAgentSetting

Anger egenskaperna för proxyagentinställningar för ett PSVirtualMachine-objekt.

Syntax

Default (Standard)

Set-AzVMProxyAgentSetting
    -VM <PSVirtualMachine>
    [-EnableProxyAgent <Boolean>]
    [-WireServerMode <String>]
    [-WireServerProfile <String>]
    [-ImdsMode <String>]
    [-ImdsProfile <String>]
    [-KeyIncarnationId <Int32>]
    [-AddProxyAgentExtension <Boolean>]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

Description

Anger egenskaperna för proxyagentinställningar för ett PSVirtualMachine-objekt.

Exempel

Exempel 1

$vmconfig = New-AzVMConfig -VMName $vmName -VMSize "Standard_D2s_v3"
Set-AzVMProxyAgentSetting -VM $vmconfig -EnableProxyAgent $true -AddProxyAgentExtension false -WireServerMode "Enforce" -ImdsProfile "/subscriptions/{SubscriptionId}/resourceGroups/{ResourceGroupName}/providers/Microsoft.Compute/galleries/{galleryName}/inVMAccessControlProfiles/{profile}/versions/{version}"

Det här kommandot anger inställningarna för proxyagenten för ett konfigurationsobjekt för virtuella datorer . Den aktiverar proxyagenten, anger trådserverläget till "Framtvinga" anger IMDS-profilen.

Parametrar

-AddProxyAgentExtension

Anger om proxyagenttillägget ska installeras implicit. Det här alternativet gäller för närvarande endast för Linux OS.

Parameteregenskaper

Typ:

Nullable<T>[Boolean]

Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-DefaultProfile

Autentiseringsuppgifter, konto, klientorganisation och prenumeration som används för kommunikation med Azure.

Parameteregenskaper

Typ:IAzureContextContainer
Standardvärde:None
Stöder jokertecken:False
DontShow:False
Alias:AzContext, AzureRmContext, AzureCredential

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-EnableProxyAgent

Anger om funktionen Metadata Security Protocol (ProxyAgent) ska vara aktiverad eller inte.

Parameteregenskaper

Typ:

Nullable<T>[Boolean]

Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-ImdsMode

Anger körningsläget för IMDS-slutpunkten. I granskningsläge fungerar systemet som om det tillämpar åtkomstkontrollprincipen, inklusive att generera åtkomstnekande poster i loggarna, men det nekar faktiskt inte några begäranden om värdslutpunkter. I framtvinga läge framtvingar systemet åtkomstkontrollen och det är det rekommenderade driftsläget.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-ImdsProfile

Anger resurs-ID:t InVMAccessControlProfileVersion i IMDS-enpointen. Format för /subscriptions/{SubscriptionId}/resourceGroups/{ResourceGroupName}/providers/Microsoft.Compute/galleries/{galleryName}/inVMAccessControlProfiles/{profile}/versions/{version}

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-KeyIncarnationId

Om du ökar värdet för den här parametern kan användarna återställa nyckeln som används för att skydda kommunikationskanalen mellan gäst och värd.

Parameteregenskaper

Typ:

Nullable<T>[Int32]

Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-VM

PSVirtualMachine-objekt som skapats från New-AzVMConfig.

Parameteregenskaper

Typ:PSVirtualMachine
Standardvärde:None
Stöder jokertecken:False
DontShow:False
Alias:VirtualMachine (VirtualMachine)

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:True
Värde från pipeline:True
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-WireServerMode

Anger trådserverns slutpunktskörningsläge när den virtuella datorn eller vm-skalningsuppsättningen skapas. I granskningsläge fungerar systemet som om det tillämpar åtkomstkontrollprincipen, inklusive att generera åtkomstnekande poster i loggarna, men det nekar faktiskt inte några begäranden om värdslutpunkter. I framtvinga läge framtvingar systemet åtkomstkontrollen och det är det rekommenderade driftsläget.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-WireServerProfile

Anger resurs-ID:t InVMAccessControlProfileVersion i Wire Server-slutpunkten. Format för /subscriptions/{SubscriptionId}/resourceGroups/{ResourceGroupName}/providers/Microsoft.Compute/galleries/{galleryName}/inVMAccessControlProfiles/{profile}/versions/{version}

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

CommonParameters

Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

Indata

PSVirtualMachine

SwitchParameter

String

Int32

Utdata

PSVirtualMachine