Freigeben über


New-AzureAffinityGroup

Erstellt eine Affinitätsgruppe im aktuellen Abonnement.

Hinweis

Die Cmdlets, auf die in dieser Dokumentation verwiesen wird, dienen zum Verwalten von Azure-Legacyressourcen, die Azure Dienst-Manager (ASM) APIs verwenden. Dieses ältere PowerShell-Modul wird beim Erstellen neuer Ressourcen nicht empfohlen, da ASM für den Ruhestand geplant ist. Weitere Informationen finden Sie unter Einstellung des Azure Service Manager.

Das Az PowerShell-Modul ist das empfohlene PowerShell-Modul zum Verwalten von Azure Resource Manager (ARM)-Ressourcen mit PowerShell.

Syntax

New-AzureAffinityGroup
   [-Name] <String>
   [-Label <String>]
   [-Description <String>]
   -Location <String>
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]

Beschreibung

Das Cmdlet New-AzureAffinityGroup erstellt eine Azure-Affinitätsgruppe im aktuellen Azure-Abonnement.

Eine Affinitätsgruppe fügt Ihre Dienste und ihre Ressourcen in einem Azure-Rechenzentrum zusammen. Die Affinitätsgruppenmitglieder gruppieren Mitglieder zusammen, um eine optimale Leistung zu erzielen. Definieren Sie Affinitätsgruppen auf Abonnementebene. Ihre Affinitätsgruppen stehen allen nachfolgenden Clouddiensten oder Speicherkonten zur Verfügung, die Sie erstellen. Sie können Dienste nur dann zu einer Affinitätsgruppe hinzufügen, wenn Sie sie erstellen.

Beispiele

Beispiel 1: Erstellen einer Affinitätsgruppe

PS C:\> New-AzureAffinityGroup -Name "South01" -Location "South Central US" -Label "South Region" -Description "Affinity group for production applications in southern region."

Mit diesem Befehl wird eine Affinitätsgruppe namens "South01" in der Region "South Central US" erstellt. Der Befehl gibt eine Beschriftung und eine Beschreibung an.

Parameter

-Description

Gibt eine Beschreibung für die Affinitätsgruppe an. Die Beschreibung kann bis zu 1024 Zeichen lang sein.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-InformationAction

Gibt an, wie dieses Cmdlet auf ein Informationsereignis reagiert.

Zulässige Werte für diesen Parameter:

  • Fortsetzen
  • Ignorieren
  • Inquire
  • SilentlyContinue
  • Beenden
  • Angehalten
Typ:ActionPreference
Aliase:infa
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-InformationVariable

Gibt eine Informationsvariable an.

Typ:String
Aliase:iv
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Label

Gibt eine Bezeichnung für die Affinitätsgruppe an. Die Beschriftung darf bis zu 100 Zeichen lang sein.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Location

Gibt den geografischen Standort des Azure-Rechenzentrums an, an dem dieses Cmdlet die Affinitätsgruppe erstellt.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Name

Gibt einen Namen für die Affinitätsgruppe an. Der Name muss für das Abonnement eindeutig sein.

Typ:String
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Profile

Gibt das Azure-Profil an, aus dem dieses Cmdlet liest. Wenn Sie kein Profil angeben, liest dieses Cmdlet aus dem lokalen Standardprofil.

Typ:AzureSMProfile
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False