Udostępnij przez

New-AzADGroup

Moduł:
Az.Resources Module

Dodaje nową jednostkę do grup

Składnia

Default (domyślnie) 

New-AzADGroup
    -DisplayName <String>
    -MailNickname <String>
    [-AcceptedSender <IMicrosoftGraphDirectoryObject[]>]
    [-AdditionalProperties <Hashtable>]
    [-AppRoleAssignment <IMicrosoftGraphAppRoleAssignmentAutoGenerated[]>]
    [-Classification <String>]
    [-CreatedOnBehalfOf <IMicrosoftGraphDirectoryObject>]
    [-DeletedDateTime <DateTime>]
    [-Description <String>]
    [-GroupType <String[]>]
    [-HasMembersWithLicenseError]
    [-IsArchived]
    [-IsAssignableToRole]
    [-MailEnabled]
    [-MembershipRule <String>]
    [-MembershipRuleProcessingState <String>]
    [-PermissionGrant <IMicrosoftGraphResourceSpecificPermissionGrant[]>]
    [-PreferredDataLocation <String>]
    [-PreferredLanguage <String>]
    [-SecurityEnabled]
    [-SecurityIdentifier <String>]
    [-Theme <String>]
    [-TransitiveMember <IMicrosoftGraphDirectoryObject[]>]
    [-TransitiveMemberOf <IMicrosoftGraphDirectoryObject[]>]
    [-Visibility <String>]
    [-DefaultProfile <PSObject>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Opis

Dodaje nową jednostkę do grup

Przykłady

Przykład 1. Tworzenie grupy

New-AzADGroup -DisplayName $gname -MailNickname $nickname

Tworzenie grupy

Parametry

-AcceptedSender

Lista użytkowników lub grup, które mogą tworzyć zdarzenia wpisu lub kalendarza w tej grupie. Jeśli ta lista nie jest pusta, tylko użytkownicy lub grupy wymienione tutaj mogą publikować posty. Aby utworzyć tabelę, zobacz sekcję UWAGI dla właściwości ACCEPTEDSENDER i utwórz tabelę skrótów.

Właściwości parametru

Typ:

IMicrosoftGraphDirectoryObject[]

Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-AdditionalProperties

Dodatkowe parametry

Właściwości parametru

Typ:Hashtable
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-AppRoleAssignment

Reprezentuje role aplikacji, którym przyznano grupę dla aplikacji. Obsługuje $expand. Aby utworzyć, zobacz sekcję UWAGI dla właściwości APPROLEASSIGNMENT i utwórz tabelę skrótów.

Właściwości parametru

Typ:

IMicrosoftGraphAppRoleAssignmentAutoGenerated[]

Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-Classification

Opisuje klasyfikację dla grupy (na przykład niski, średni lub wysoki wpływ na firmę). Prawidłowe wartości dla tej właściwości są definiowane przez utworzenie wartości ustawienia ClassificationList na podstawie definicji szablonu. Zwracane domyślnie. Obsługuje $filter (eq, ne, NOT, ge, le, startsWith).

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-Confirm

Prosi o potwierdzenie przed uruchomieniem cmdletu.

Właściwości parametru

Typ:SwitchParameter
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False
Aliasy:por

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-CreatedOnBehalfOf

Reprezentuje obiekt usługi Azure Active Directory. Typ directoryObject jest typem podstawowym dla wielu innych typów jednostek katalogu. Aby utworzyć tabelę, zobacz sekcję NOTES dla właściwości CREATEDONBEHALFOF i utwórz tabelę skrótów.

Właściwości parametru

Typ:IMicrosoftGraphDirectoryObject
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-DefaultProfile

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

Właściwości parametru

Typ:PSObject
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False
Aliasy:AzContext, AzureRmContext, AzureCredential

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-DeletedDateTime

.

Właściwości parametru

Typ:DateTime
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-Description

Opcjonalny opis grupy. Zwracane domyślnie. Obsługuje $filter (eq, ne, NOT, ge, le, startsWith) i $search.

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-DisplayName

Nazwa wyświetlana grupy. Ta właściwość jest wymagana, gdy grupa jest tworzona i nie można jej wyczyścić podczas aktualizacji. Zwracane domyślnie. Obsługuje $filter (eq, ne, NOT, ge, le, in, startsWith), $search i $orderBy.

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:True
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-GroupType

Określa typ grupy i jego członkostwo. Jeśli kolekcja zawiera unified, grupa jest grupą platformy Microsoft 365; w przeciwnym razie jest to grupa zabezpieczeń lub grupa dystrybucyjna. Aby uzyskać szczegółowe informacje, zobacz omówienie grup. Jeśli kolekcja zawiera element DynamicMembership, grupa ma członkostwo dynamiczne; w przeciwnym razie członkostwo jest statyczne. Zwracane domyślnie. Obsługuje $filter (eq, NOT).

Właściwości parametru

Typ:

String[]

Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-HasMembersWithLicenseError

Wskazuje, czy w tej grupie znajdują się członkowie, którzy mają błędy licencji z przypisania licencji opartej na grupie. Ta właściwość nigdy nie jest zwracana w operacji GET. Można go użyć jako argumentu $filter, aby uzyskać grupy, które mają członków z błędami licencji (czyli filtr dla tej właściwości ma wartość true). Obsługuje $filter (eq).

Właściwości parametru

Typ:SwitchParameter
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-IsArchived

.

Właściwości parametru

Typ:SwitchParameter
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-IsAssignableToRole

Wskazuje, czy tę grupę można przypisać do roli usługi Azure Active Directory. Tę właściwość można ustawić tylko podczas tworzenia grupy i jest niezmienna. Jeśli ustawiono wartość true, właściwość securityEnabled musi być również ustawiona na wartość true, a grupa nie może być grupą dynamiczną (czyli groupTypes nie może zawierać parametru DynamicMembership). Tylko osoby wywołujące w rolach administratora globalnego i administratora ról uprzywilejowanych mogą ustawić tę właściwość. Obiekt wywołujący musi również mieć przypisane uprawnienie Directory.AccessAsUser.All, aby ustawić tę właściwość. Aby uzyskać więcej informacji, zobacz Używanie grupy do zarządzania przypisaniami ról usługi Azure ADReturned domyślnie. Obsługuje $filter (eq, ne, NOT).

Właściwości parametru

Typ:SwitchParameter
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-MailEnabled

Określa, czy grupa jest włączona do poczty. Zwracane domyślnie. Obsługuje $filter (eq, ne, NOT).

Właściwości parametru

Typ:SwitchParameter
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-MailNickname

Alias poczty dla grupy, unikatowy w organizacji. Ta właściwość musi być określona podczas tworzenia grupy. Tych znaków nie można używać w mailNickName: @()/[]';:.<>,SPACJA. Zwracane domyślnie. Obsługuje $filter (eq, ne, NOT, ge, le, in, startsWith).

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:True
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-MembershipRule

Reguła określająca członków tej grupy, jeśli grupa jest grupą dynamiczną (groupTypes zawiera element DynamicMembership). Aby uzyskać więcej informacji na temat składni reguły członkostwa, zobacz Składnia reguł członkostwa. Zwracane domyślnie. Obsługuje $filter (eq, ne, NOT, ge, le, startsWith).

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-MembershipRuleProcessingState

Wskazuje, czy przetwarzanie członkostwa dynamicznego jest włączone, czy wstrzymane. Możliwe wartości to Włączone lub Wstrzymane. Zwracane domyślnie. Obsługuje $filter (eq, ne, NOT, in).

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-PermissionGrant

Uprawnienia, które zostały przyznane dla grupy dla określonej aplikacji. Obsługuje $expand. Aby utworzyć tabelę, zobacz sekcję UWAGI dla właściwości PERMISSIONGRANT i utwórz tabelę skrótów.

Właściwości parametru

Typ:

IMicrosoftGraphResourceSpecificPermissionGrant[]

Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-PreferredDataLocation

Preferowana lokalizacja danych dla grupy. Aby uzyskać więcej informacji, zobacz Usługa OneDrive Online Multi-Geo. Zwracane domyślnie.

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-PreferredLanguage

Preferowany język dla grupy platformy Microsoft 365. Należy postępować zgodnie z kodem ISO 639-1; na przykład "en-US". Zwracane domyślnie. Obsługuje $filter (eq, ne, NOT, ge, le, in, startsWith).

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-SecurityEnabled

Określa, czy grupa jest grupą zabezpieczeń. Zwracane domyślnie. Obsługuje $filter (eq, ne, NOT, in).

Właściwości parametru

Typ:SwitchParameter
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-SecurityIdentifier

Identyfikator zabezpieczeń grupy używany w scenariuszach systemu Windows. Zwracane domyślnie.

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-Theme

Określa motyw kolorów grupy platformy Microsoft 365. Możliwe wartości to Teal, Purple, Green, Blue, Pink, Orange lub Red. Zwracane domyślnie.

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-TransitiveMember

. Aby utworzyć tabelę, zobacz sekcję UWAGI dla właściwości TRANSITIVEMEMBER i utwórz tabelę skrótów.

Właściwości parametru

Typ:

IMicrosoftGraphDirectoryObject[]

Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-TransitiveMemberOf

. Aby utworzyć, zobacz sekcję UWAGI dla właściwości TRANSITIVEMEMBEROF i utwórz tabelę skrótów.

Właściwości parametru

Typ:

IMicrosoftGraphDirectoryObject[]

Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-Visibility

Określa zasady dołączania grupy i widoczność zawartości grupy dla grup. Możliwe wartości to: Private, Public lub Hiddenmembership. Ustawienie Hiddenmembership można ustawić tylko dla grup platformy Microsoft 365 po utworzeniu grup. Nie można go zaktualizować później. Inne wartości widoczności można zaktualizować po utworzeniu grupy. Jeśli wartość widoczności nie jest określona podczas tworzenia grupy w programie Microsoft Graph, grupa zabezpieczeń jest tworzona jako prywatna domyślnie, a grupa platformy Microsoft 365 jest publiczna. Zobacz opcje widoczności grupy, aby dowiedzieć się więcej. Zwracane domyślnie.

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-WhatIf

Pokazuje, co się stanie, jeśli polecenie cmdlet zostanie uruchomione. Cmdlet nie jest uruchomiony.

Właściwości parametru

Typ:SwitchParameter
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False
Aliasy:Wi

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

CommonParameters

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.

Dane wyjściowe

IMicrosoftGraphGroup