Update-AzADGroup

Aktualizace entity ve skupinách

Syntax

UpdateExpanded (Výchozí)

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>]

UpdateViaJsonFilePath

Update-AzADGroup
    -ObjectId <String>
    -JsonFilePath <String>
    [-DefaultProfile <PSObject>]
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

UpdateViaJsonString

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 $description

Aktualizovat popis skupiny

Parametry

-AdditionalProperties

Další parametry

Vlastnosti parametru

Typ:Hashtable
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

UpdateExpanded
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-AppRoleAssignment

Představuje role aplikace, které skupina byla udělena pro aplikaci. Podporuje $expand.

Vlastnosti parametru

Typ:

IMicrosoftGraphAppRoleAssignmentAutoGenerated[]

Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

UpdateExpanded
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů: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).

Vlastnosti parametru

Typ:String
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

UpdateExpanded
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-Confirm

Před spuštěním cmdletu vás vyzve k potvrzení.

Vlastnosti parametru

Typ:SwitchParameter
Default value:None
Podporuje zástupné znaky:False
DontShow:False
Aliasy:viz

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-CreatedOnBehalfOf

Představuje objekt Azure Active Directory. Typ directoryObject je základní typ pro mnoho dalších typů entit adresáře.

Vlastnosti parametru

Typ:IMicrosoftGraphDirectoryObject
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

UpdateExpanded
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-DefaultProfile

Parametr DefaultProfile není funkční. Pokud je k dispozici spuštění rutiny pro jiné předplatné, použijte parametr SubscriptionId.

Vlastnosti parametru

Typ:PSObject
Default value:None
Podporuje zástupné znaky:False
DontShow:False
Aliasy:AzureRMContext, AzureCredential

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-DeletedDateTime

.

Vlastnosti parametru

Typ:DateTime
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

UpdateExpanded
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-Description

Volitelný popis skupiny Vrátí se ve výchozím nastavení. Podporuje $filter (eq, ne, NOT, ge, le, startsWith) a $search.

Vlastnosti parametru

Typ:String
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

UpdateExpanded
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-DisplayName

Název zobrazený v adresáři

Vlastnosti parametru

Typ:String
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

UpdateExpanded
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-GroupType

Určuje typ skupiny a její členství. Pokud kolekce obsahuje sjednocenou kolekci, 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).

Vlastnosti parametru

Typ:

String[]

Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

UpdateExpanded
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů: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).

Vlastnosti parametru

Typ:SwitchParameter
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

UpdateExpanded
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-IsArchived

.

Vlastnosti parametru

Typ:SwitchParameter
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

UpdateExpanded
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-IsAssignableToRole

Určuje, zda lze tuto skupinu 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 správce Globální správce a 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ě Azure přiřazení rolí AD Ve výchozím nastavení. Podporuje $filter (eq, ne, NOT).

Vlastnosti parametru

Typ:SwitchParameter
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

UpdateExpanded
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-JsonFilePath

Cesta k souboru JSON zadanému pro operaci aktualizace

Vlastnosti parametru

Typ:String
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

UpdateViaJsonFilePath
Position:Named
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-JsonString

Řetězec JSON zadaný pro operaci aktualizace

Vlastnosti parametru

Typ:String
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

UpdateViaJsonString
Position:Named
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-MailEnabled

Určuje, jestli má skupina povolenou poštu. Vrátí se ve výchozím nastavení. Podporuje $filter (eq, ne, NOT).

Vlastnosti parametru

Typ:SwitchParameter
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

UpdateExpanded
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů: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: @()/[]';:.<>,MEZERNÍK. Vrátí se ve výchozím nastavení. Podporuje $filter (eq, ne, NOT, ge, le, in, startsWith).

Vlastnosti parametru

Typ:String
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

UpdateExpanded
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-MembershipRule

Pravidlo, které určuje členy pro tuto skupinu, pokud je skupina dynamická (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).

Vlastnosti parametru

Typ:String
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

UpdateExpanded
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-MembershipRuleProcessingState

Označuje, jestli je dynamické zpracování členství zapnuté nebo pozastavené. Možné hodnoty jsou Zapnuto nebo Pozastaveno. Vrátí se ve výchozím nastavení. Podporuje $filter (eq, ne, NOT, in).

Vlastnosti parametru

Typ:String
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

UpdateExpanded
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-ObjectId

key: ID skupiny

Vlastnosti parametru

Typ:String
Default value:None
Podporuje zástupné znaky:False
DontShow:False
Aliasy:Identifikátor skupiny

Sady parametrů

(All)
Position:Named
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-PassThru

Vrátí hodnotu true, když příkaz proběhne úspěšně.

Vlastnosti parametru

Typ:SwitchParameter
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-PermissionGrant

Oprávnění udělená pro skupinu pro konkrétní aplikaci. Podporuje $expand.

Vlastnosti parametru

Typ:

IMicrosoftGraphResourceSpecificPermissionGrant[]

Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

UpdateExpanded
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů: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í.

Vlastnosti parametru

Typ:String
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

UpdateExpanded
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-PreferredLanguage

Preferovaný jazyk pro skupinu Microsoft 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).

Vlastnosti parametru

Typ:String
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

UpdateExpanded
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-SecurityEnabled

Určuje, jestli je skupina skupinou zabezpečení. Vrátí se ve výchozím nastavení. Podporuje $filter (eq, ne, NOT, in).

Vlastnosti parametru

Typ:SwitchParameter
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

UpdateExpanded
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů: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í.

Vlastnosti parametru

Typ:String
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

UpdateExpanded
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů: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í.

Vlastnosti parametru

Typ:String
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

UpdateExpanded
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů: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émberství lze nastavit pouze pro Microsoft 365 skupiny při vytváření skupin. Nejde ho později aktualizovat. Po vytvoření skupiny je možné aktualizovat další hodnoty viditelnosti. Pokud při vytváření skupiny v Microsoft Graph není zadána hodnota viditelnosti, vytvoří se skupina zabezpečení ve výchozím nastavení jako soukromá a Microsoft 365 skupina je veřejná. Další informace najdete v možnostech viditelnosti skupiny. Vrátí se ve výchozím nastavení.

Vlastnosti parametru

Typ:String
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

UpdateExpanded
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-WhatIf

Ukazuje, co se stane, když se příkaz spustí. Příkazový modul nebyl spuštěn.

Vlastnosti parametru

Typ:SwitchParameter
Default value:None
Podporuje zástupné znaky:False
DontShow:False
Aliasy:Wi

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

CommonParameters

Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.

Výstupy

Boolean