Freigeben über


New-AzProximityPlacementGroup

Erstellen Sie die Ressource "Näherungsplatzierungsgruppe".

Syntax

New-AzProximityPlacementGroup
   [-ResourceGroupName] <String>
   [-Name] <String>
   [-Location] <String>
   [-ProximityPlacementGroupType <String>]
   [-Tag <Hashtable>]
   [-AsJob]
   [-Zone <String[]>]
   [-IntentVMSizeList <String[]>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Beschreibung

Mit diesem Cmdlet wird die Ressource "Näherungsplatzierungsgruppe" erstellt.

Beispiele

Beispiel 1

New-AzProximityPlacementGroup -ResourceGroupName $resourceGroupName -Name $proximityPlacementGroupName -Location $location -Tag @{key1 = "val1"}

ResourceGroupName           : rg0
ProximityPlacementGroupType : Standard
Id                          : /subscriptions/5393f919-a68a-43d0-9063-4b2bda6bffdf/resourceGroups/rg0/providers/Microsoft.Compute/proximityPlacementGroups/ppg0
Name                        : ppg0
Type                        : Microsoft.Compute/proximityPlacementGroups
Location                    : westcentralus
Tags                        : {"key1":"val1"}

Mit diesem Befehl wird eine Näherungsplatzgruppe an der angegebenen Position erstellt.

Beispiel 2

Erstellen Sie die Ressource "Näherungsplatzierungsgruppe". (automatisch generiert)

New-AzProximityPlacementGroup -Location westus -Name 'AgentPool01' -ProximityPlacementGroupType <String> -ResourceGroupName myresourcegroup

Beispiel 3

$ResourceGroupName = <Resource Group Name>
$PPGName = <PPG Name>
$Location = <Azure Region>
# Use the VM Sizes and Zone that you want to use for the Zone and IntentVMSizeList parameters. 
New-AzProximityPlacementGroup -ResourceGroupName $ResourceGroupName -Name $PPGName -Location $Location -Zone '1' -IntentVMSizeList 'Standard_D4d_v4', 'Standard_D4d_v5';
$ppg = Get-AzProximityPlacementGroup -ResourceGroupName $ResourceGroupName -Name $PPGName;

# View the new values at $ppg.Intent.VmSizes[0], $ppg.Intent.VmSizes[1], and $ppg.Zones[0].

Parameter

-AsJob

Cmdlet im Hintergrund ausführen

Type:SwitchParameter
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

-DefaultProfile

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

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-IntentVMSizeList

Gibt mögliche Größen virtueller Computer an, die in der Näherungsplatzierungsgruppe erstellt werden können.

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

-Location

Ressourcenspeicherort

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

-Name

Der Name der Näherungsplatzierungsgruppe.

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

-ProximityPlacementGroupType

Gibt den Typ der Näherungsplatzierungsgruppe an. Mögliche Werte sind: Standard oder Ultra

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

-ResourceGroupName

Der Name der Ressourcengruppe.

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

-Tag

Ressourcentags

Type:Hashtable
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

-Zone

Gibt die Verfügbarkeitszone an, in der virtuelle Computer, Skalierungsgruppe oder Verfügbarkeitsgruppe für virtuelle Computer erstellt werden können, die der Näherungsplatzierungsgruppe zugeordnet sind.

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

Eingaben

String

Ausgaben

PSProximityPlacementGroup