Compartilhar via


New-AzureAffinityGroup

Cria um grupo de afinidade na assinatura atual.

Observação

Os cmdlets mencionados nesta documentação são para gerenciar recursos herdados do Azure que usam APIs do Azure Service Manager (ASM). Este módulo herdado do PowerShell não é recomendado ao criar novos recursos, já que o ASM está programado para desativação. Para obter mais informações, consulte Aposentadoria do Azure Service Manager.

O módulo Az PowerShell é o módulo do PowerShell recomendado para gerenciar recursos do Azure Resource Manager (ARM) com o PowerShell.

Sintaxe

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

Description

O cmdlet New-AzureAffinityGroup cria um grupo de afinidade do Azure na assinatura atual do Azure.

Um grupo de afinidade reúne seus serviços e seus recursos em um datacenter do Azure. O grupo de afinidade agrupa os membros para um desempenho ideal. Defina grupos de afinidade no nível de assinatura. Seus grupos de afinidade estão disponíveis para quaisquer serviços de nuvem ou contas de armazenamento subsequentes que você criar. Você pode adicionar serviços a um grupo de afinidade somente quando criá-lo.

Exemplos

Exemplo 1: Criar um grupo de afinidade

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

Esse comando cria um grupo de afinidade chamado South01 na região Centro-Sul dos EUA. O comando especifica um rótulo e uma descrição.

Parâmetros

-Description

Especifica uma descrição para o grupo de afinidade. A descrição pode ter até 1024 caracteres.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-InformationAction

Especifica como esse cmdlet responde a um evento de informações.

Os valores aceitáveis para esse parâmetro são:

  • Continuar
  • Ignorar
  • Perguntar
  • SilentlyContinue
  • Parar
  • Suspend
Tipo:ActionPreference
Aliases:infa
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-InformationVariable

Especifica uma variável de informação.

Tipo:String
Aliases:iv
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Label

Especifica um rótulo para o grupo de afinidade. O rótulo pode ter até 100 caracteres.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Location

Especifica o local geográfico do datacenter do Azure onde esse cmdlet cria o grupo de afinidade.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Name

Especifica um nome para o grupo de afinidade. O nome deve ser exclusivo da assinatura.

Tipo:String
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-Profile

Especifica o perfil do Azure a partir do qual este cmdlet lê. Se você não especificar um perfil, esse cmdlet será lido a partir do perfil padrão local.

Tipo:AzureSMProfile
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False