Get-AzManagementGroupNameAvailability

Sprawdza, czy nazwa grupy zarządzania jest dostępna w dzierżawie i prawidłową nazwę.

Składnia

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

Opis

Polecenie Get-AzManagementGroupNameAvailability sprawdza, czy nazwa grupy zarządzania jest dostępna i prawidłowa

Przykłady

Przykład 1. Uzyskiwanie dostępności nazwy dla prawidłowej nazwy

Get-AzManagementGroupNameAvailability -GroupName "testMG"

Message              : 
NameAvailable        : True
Reason               :

Przykład 2. Uzyskiwanie dostępności nazwy dla nazwy, która jest już zajęta

Get-AzManagementGroupNameAvailability -GroupName "testMG3"

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

Przykład 3. Uzyskiwanie dostępności nazwy dla nazwy zawierającej nieprawidłowe znaki

Get-AzManagementGroupNameAvailability -GroupName "testMG!"

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

Parametry

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

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

-DefaultProfile

Poświadczenia, konto, dzierżawa i subskrypcja używane do komunikacji z platformą Azure.

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

-GroupName

Nazwa grupy zarządzania

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

-WhatIf

Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie zostało uruchomione.

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

Dane wejściowe

None

Dane wyjściowe

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