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.