Edit

Share via


New-AzNetworkCloudVirtualMachinePlacementHintObject

Create an in-memory object for VirtualMachinePlacementHint.

Syntax

Default (Default)

New-AzNetworkCloudVirtualMachinePlacementHintObject
    -HintType <VirtualMachinePlacementHintType>
    -ResourceId <String>
    -SchedulingExecution <VirtualMachineSchedulingExecution>
    -Scope <VirtualMachinePlacementHintPodAffinityScope>
    [<CommonParameters>]

Description

Create an in-memory object for VirtualMachinePlacementHint.

Examples

Example 1: Create an in-memory object for VirtualMachinePlacementHint.

New-AzNetworkCloudVirtualMachinePlacementHintObject -HintType "Affinity" -ResourceId "/subscriptions/subscriptionId/resourceGroups/resourceGroupName/providers/Microsoft.NetworkCloud/racks/rackName" -SchedulingExecution "Hard" -Scope "Machine"
HintType ResourceId                                                                                                     SchedulingExecution Scope
-------- ----------                                                                                                     ------------------- -----
Affinity /subscriptions/subscriptionId/resourceGroups/resourceGroupName/providers/Microsoft.NetworkCloud/racks/rackName Hard                Machine

Creates an in-memory object for VirtualMachinePlacementHint.

Parameters

-HintType

The specification of whether this hint supports affinity or anti-affinity with the referenced resources.

Parameter properties

Type:VirtualMachinePlacementHintType
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-ResourceId

The resource ID of the target object that the placement hints will be checked against, e.g., the bare metal node to host the virtual machine.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-SchedulingExecution

The indicator of whether the hint is a hard or soft requirement during scheduling.

Parameter properties

Type:VirtualMachineSchedulingExecution
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Scope

The scope for the virtual machine affinity or anti-affinity placement hint. It should always be "Machine" in the case of node affinity.

Parameter properties

Type:VirtualMachinePlacementHintPodAffinityScope
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

Outputs

VirtualMachinePlacementHint