Get-AzManagementGroupNameAvailability

Referência

Módulo:: Az.Resources

Verifica se o nome do Grupo de Gerenciamento está disponível no Locatário e um nome válido.

Syntax

Get-AzManagementGroupNameAvailability
   [-GroupName] <String>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

O Get-AzManagementGroupNameAvailability verifica se um Nome de Grupo de Gerenciamento está Disponível e Válido

Exemplos

Exemplo 1: Obter a disponibilidade de nome para um nome válido

Get-AzManagementGroupNameAvailability -GroupName "testMG"

Message              : 
NameAvailable        : True
Reason               :

Exemplo 2: Obter a disponibilidade de nome para um nome que já foi utilizado

Get-AzManagementGroupNameAvailability -GroupName "testMG3"

Message              : The group with the specified name already exists
NameAvailable        : False
Reason               : AlreadyExists

Exemplo 3: Obter a disponibilidade de nome para um nome que contém caracteres inválidos

Get-AzManagementGroupNameAvailability -GroupName "testMG!"

Message              : The provided management group name has invalid characters
NameAvailable        : False
Reason               : Invalid

Parâmetros

-Confirm

Solicita a sua confirmação antes de executar o cmdlet.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DefaultProfile

As credenciais, a conta, o locatário e a assinatura usados para comunicação com o Azure.

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

-GroupName

Nome do Grupo de Gerenciamento

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

-WhatIf

Apresenta o que aconteceria mediante a execução do cmdlet. O cmdlet não é executado.

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Entradas

None

Saídas

Microsoft.Azure.Commands.Resources.Models.ManagementGroups.PSManagementGroupNameAvailabilityResult