Freigeben über


Get-AzManagementGroupNameAvailability

Überprüft, ob der Verwaltungsgruppenname im Mandanten und einem gültigen Namen verfügbar ist.

Syntax

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

Beschreibung

Die Get-AzManagementGroupNameAvailability überprüft, ob ein Verwaltungsgruppenname verfügbar und gültig ist.

Beispiele

Beispiel 1: Abrufen der Namensverfügbarkeit für einen gültigen Namen

Get-AzManagementGroupNameAvailability -GroupName "testMG"

Message              : 
NameAvailable        : True
Reason               :

Beispiel 2: Abrufen der Namensverfügbarkeit für einen namen, der bereits verwendet wurde

Get-AzManagementGroupNameAvailability -GroupName "testMG3"

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

Beispiel 3: Abrufen der Namensverfügbarkeit für einen Namen, der ungültige Zeichen enthält

Get-AzManagementGroupNameAvailability -GroupName "testMG!"

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

Parameter

-Confirm

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

Typ:SwitchParameter
Aliase:cf
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DefaultProfile

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

Typ:IAzureContextContainer
Aliase:AzContext, AzureRmContext, AzureCredential
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-GroupName

Verwaltungsgruppenname

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

-WhatIf

Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Typ:SwitchParameter
Aliase:wi
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

None

Ausgaben

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