Update-AzADGroup
aktualizace entity ve skupinách
Syntaxe
Update-AzADGroup
-ObjectId <String>
[-AdditionalProperties <Hashtable>]
[-AppRoleAssignment <IMicrosoftGraphAppRoleAssignmentAutoGenerated[]>]
[-Classification <String>]
[-CreatedOnBehalfOf <IMicrosoftGraphDirectoryObject>]
[-DeletedDateTime <DateTime>]
[-Description <String>]
[-DisplayName <String>]
[-GroupType <String[]>]
[-HasMembersWithLicenseError]
[-IsArchived]
[-IsAssignableToRole]
[-MailEnabled]
[-MailNickname <String>]
[-MembershipRule <String>]
[-MembershipRuleProcessingState <String>]
[-PermissionGrant <IMicrosoftGraphResourceSpecificPermissionGrant[]>]
[-PreferredDataLocation <String>]
[-PreferredLanguage <String>]
[-SecurityEnabled]
[-SecurityIdentifier <String>]
[-Theme <String>]
[-Visibility <String>]
[-DefaultProfile <PSObject>]
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Update-AzADGroup
-ObjectId <String>
-JsonFilePath <String>
[-DefaultProfile <PSObject>]
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Update-AzADGroup
-ObjectId <String>
-JsonString <String>
[-DefaultProfile <PSObject>]
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Description
aktualizace entity ve skupinách
Příklady
Příklad 1: Aktualizace popisu skupiny
Update-AzADGroup -ObjectId $objectid -Description $descriptionAktualizovat popis skupiny
Parametry
-AdditionalProperties
Další parametry
| Typ: | Hashtable |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-AppRoleAssignment
Představuje role aplikace, které skupina byla udělena pro aplikaci. Podporuje $expand.
| Typ: | IMicrosoftGraphAppRoleAssignmentAutoGenerated[] |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-Classification
Popisuje klasifikaci skupiny (například nízký, střední nebo vysoký obchodní dopad). Platné hodnoty pro tuto vlastnost jsou definovány vytvořením hodnoty nastavení ClassificationList na základě definice šablony. Vrátí se ve výchozím nastavení. Podporuje $filter (eq, ne, NOT, ge, le, startsWith).
| Typ: | String |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-Confirm
Před spuštěním rutiny vás vyzve k potvrzení.
| Typ: | SwitchParameter |
| Aliasy: | cf |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-CreatedOnBehalfOf
Představuje objekt Azure Active Directory. Typ directoryObject je základní typ pro mnoho dalších typů entit adresáře.
| Typ: | IMicrosoftGraphDirectoryObject |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-DefaultProfile
Parametr DefaultProfile není funkční. Pokud je k dispozici spuštění rutiny pro jiné předplatné, použijte parametr SubscriptionId.
| Typ: | PSObject |
| Aliasy: | AzureRMContext, AzureCredential |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-DeletedDateTime
.
| Typ: | DateTime |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-Description
Volitelný popis skupiny. Vrátí se ve výchozím nastavení. Podporuje $filter (eq, ne, NOT, ge, le, startsWith) a $search.
| Typ: | String |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-DisplayName
Název zobrazený v adresáři
| Typ: | String |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-GroupType
Určuje typ skupiny a jeho členství. Pokud kolekce obsahuje unified, skupina je skupina Microsoft 365; jinak se jedná o skupinu zabezpečení nebo distribuční skupinu. Podrobnosti najdete v přehledu skupin. Pokud kolekce obsahuje DynamicMembership, skupina má dynamické členství; v opačném případě je členství statické. Vrátí se ve výchozím nastavení. Podporuje $filter (eq, NOT).
| Typ: | String[] |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-HasMembersWithLicenseError
Určuje, jestli jsou v této skupině členové, kteří mají chyby licencí z přiřazení licence založené na skupině. Tato vlastnost se nikdy nevrátí v operaci GET. Můžete ho použít jako argument $filter k získání skupin, které mají členy s chybami licence (to znamená, že filtrování této vlastnosti je pravdivé). Podporuje $filter (eq).
| Typ: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-IsArchived
.
| Typ: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-IsAssignableToRole
Určuje, jestli se tato skupina dá přiřadit k roli Azure Active Directory. Tuto vlastnost lze nastavit pouze při vytváření skupiny a je neměnná. Pokud je nastavena hodnota true, musí být vlastnost securityEnabled nastavena také na hodnotu true a skupina nemůže být dynamickou skupinou (to znamená, že groupTypes nemůže obsahovat DynamicMembership). Tuto vlastnost můžou nastavit jenom volající v rolích globálního správce a správce privilegovaných rolí. Volajícímu musí být přiřazeno také oprávnění Directory.AccessAsUser.All k nastavení této vlastnosti. Další informace najdete v tématu Použití skupiny ke správě přiřazení rolí Azure AD Ve výchozím nastavení. Podporuje $filter (eq, ne, NOT).
| Typ: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-JsonFilePath
Cesta k souboru JSON zadanému pro operaci aktualizace
| Typ: | String |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | True |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-JsonString
Řetězec JSON zadaný pro operaci aktualizace
| Typ: | String |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | True |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-MailEnabled
Určuje, jestli je skupina povolená poštou. Vrátí se ve výchozím nastavení. Podporuje $filter (eq, ne, NOT).
| Typ: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-MailNickname
Alias pošty pro skupinu, jedinečný v organizaci. Tato vlastnost musí být zadána při vytvoření skupiny. Tyto znaky nelze použít v mailNickName: @()/[]';:.<>, MEZERA. Vrátí se ve výchozím nastavení. Podporuje $filter (eq, ne, NOT, ge, le, in, startsWith).
| Typ: | String |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-MembershipRule
Pravidlo, které určuje členy pro tuto skupinu, pokud je skupina dynamickou skupinou (groupTypes obsahuje DynamicMembership). Další informace o syntaxi pravidla členství naleznete v tématu Syntaxe pravidel členství. Vrátí se ve výchozím nastavení. Podporuje $filter (eq, ne, NOT, ge, le, startsWith).
| Typ: | String |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-MembershipRuleProcessingState
Určuje, jestli je dynamické zpracování členství zapnuté nebo pozastavené. Možné hodnoty jsou zapnuté nebo pozastavené. Vrátí se ve výchozím nastavení. Podporuje $filter (eq, ne, NOT, in).
| Typ: | String |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-ObjectId
key: ID skupiny
| Typ: | String |
| Aliasy: | GroupId |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | True |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-PassThru
Vrátí hodnotu true, když příkaz proběhne úspěšně.
| Typ: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-PermissionGrant
Oprávnění udělená pro skupinu pro konkrétní aplikaci. Podporuje $expand.
| Typ: | IMicrosoftGraphResourceSpecificPermissionGrant[] |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-PreferredDataLocation
Upřednostňované umístění dat pro skupinu. Další informace najdete v tématu OneDrive Online Multi-Geo. Vrátí se ve výchozím nastavení.
| Typ: | String |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-PreferredLanguage
Upřednostňovaný jazyk pro skupinu Microsoftu 365 Měl by následovat kód ISO 639-1; například 'en-US'. Vrátí se ve výchozím nastavení. Podporuje $filter (eq, ne, NOT, ge, le, in, startsWith).
| Typ: | String |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-SecurityEnabled
Určuje, jestli je skupina skupinou zabezpečení. Vrátí se ve výchozím nastavení. Podporuje $filter (eq, ne, NOT, in).
| Typ: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-SecurityIdentifier
Identifikátor zabezpečení skupiny, který se používá ve scénářích s Windows Vrátí se ve výchozím nastavení.
| Typ: | String |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-Theme
Určuje barevný motiv skupiny Microsoft 365. Možné hodnoty jsou Teal, Purple, Green, Blue, Pink, Orange nebo Red. Vrátí se ve výchozím nastavení.
| Typ: | String |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-Visibility
Určuje zásadu připojení ke skupině a viditelnost obsahu skupiny pro skupiny. Možné hodnoty jsou: Private, Public nebo Hiddenmembership. Skryté mbership se dají nastavit jenom pro skupiny Microsoftu 365 při vytváření skupin. Nejde ho později aktualizovat. Po vytvoření skupiny je možné aktualizovat další hodnoty viditelnosti. Pokud během vytváření skupiny v Microsoft Graphu není zadaná hodnota viditelnosti, vytvoří se ve výchozím nastavení skupina zabezpečení jako soukromá a skupina Microsoft 365 je veřejná. Další informace najdete v možnostech viditelnosti skupiny. Vrátí se ve výchozím nastavení.
| Typ: | String |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-WhatIf
Ukazuje, co se stane, když se rutina spustí. Rutina se nespustí.
| Typ: | SwitchParameter |
| Aliasy: | wi |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
Výstupy
Azure PowerShell