DSC GroupSet-erőforrás

Érintett kiadások: Windows PowerShell 5.x

A Windows PowerShell Desired State Configuration (DSC) GroupSet erőforrása egy mechanizmust biztosít a helyi csoportok kezelésére a célcsomóponton. Ez az erőforrás egy összetett erőforrás , amely meghívja a csoporterőforrást a GroupName paraméterben megadott minden csoporthoz.

Ezt az erőforrást akkor használja, ha ugyanazt a taglistát több csoporthoz szeretné hozzáadni és/vagy eltávolítani, több csoportot is el szeretne távolítani, vagy több csoportot szeretne hozzáadni ugyanazzal a taglistával.

Megjegyzés

A DSC-erőforrás dokumentációja a PowerShell 7.2-es verzió előtti verzióját ismerteti. A PSDscResources modul a Microsoft által hivatalosan támogatott új és frissített DSC-erőforrásokat tartalmaz. A PSDscResources modul a PowerShell-galéria érhető el.

További információkért és a frissített dokumentációért tekintse meg a PSDscResources referenciadokumentációját.

Syntax

GroupSet [string] #ResourceName
{
    GroupName = [string[]]
    [ MembersToInclude = [string[]] ]
    [ MembersToExclude = [string[]] ]
    [ Credential = [PSCredential] ]
    [ DependsOn = [string[]] ]
    [ Ensure = [string] { Absent | Present }  ]
    [ PsDscRunAsCredential = [PSCredential] ]
}

Tulajdonságok

Tulajdonság	Leírás
GroupName	Azoknak a csoportoknak a neve, amelyekhez egy adott állapotot szeretne biztosítani.
Tagok	Ezzel a tulajdonsággal lecserélheti az aktuális csoporttagságot a megadott tagokra. Ennek a tulajdonságnak az értéke az űrlap Domain\UserNamesztringjeinek tömbje. Ha ezt a tulajdonságot konfigurációban állítja be, ne használja a MembersToExclude vagy a MembersToInclude tulajdonságot. Ha így tesz, hibát fog eredményezni.
MembersToInclude	Ezzel a tulajdonsággal hozzáadhat tagokat a csoport meglévő tagságához. Ennek a tulajdonságnak az értéke az űrlap Domain\UserNamesztringjeinek tömbje. Ha ezt a tulajdonságot konfigurációban állítja be, ne használja a Members tulajdonságot. Ha így tesz, hibát fog eredményezni.
MembersToExclude	Ezzel a tulajdonsággal eltávolíthat tagokat a csoportok meglévő tagságából. Ennek a tulajdonságnak az értéke az űrlap Domain\UserNamesztringjeinek tömbje. Ha ezt a tulajdonságot konfigurációban állítja be, ne használja a Members tulajdonságot. Ha így tesz, hibát fog eredményezni.
Hitelesítő adat	A távoli erőforrások eléréséhez szükséges hitelesítő adatok. Ennek a fióknak rendelkeznie kell a megfelelő Active Directory-engedélyekkel ahhoz, hogy az összes nem helyi fiókot hozzáadja a csoporthoz; ellenkező esetben hiba történik.

Közös tulajdonságok

Tulajdonság	Leírás
DependsOn	Azt jelzi, hogy egy másik erőforrás konfigurációjának futnia kell az erőforrás konfigurálása előtt. Ha például az először futtatni kívánt erőforrás-konfigurációs szkriptblokk azonosítója ResourceName, és a típusa ResourceType, akkor a tulajdonság használatának szintaxisa a következő DependsOn = "[ResourceType]ResourceName": .
Biztosítja	Azt jelzi, hogy léteznek-e a csoportok. Állítsa ezt a tulajdonságot a Hiányzó értékre, és győződjön meg arról, hogy a csoportok nem léteznek. A Megosztás értékre állítása biztosítja, hogy a csoportok léteznek. Az alapértelmezett érték a Jelenik.
PsDscRunAsCredential	Beállítja a teljes erőforrás futtatásához szükséges hitelesítő adatokat.

Megjegyzés

A PsDscRunAsCredential közös tulajdonság hozzáadva a WMF 5.0-hoz, hogy bármely DSC-erőforrást más hitelesítő adatok kontextusában futtathasson. További információ: Hitelesítő adatok használata DSC-erőforrásokkal.

1. példa: Csoportok jelenlétének biztosítása

Az alábbi példa bemutatja, hogyan biztosítható, hogy a "myGroup" és a "myOtherGroup" nevű csoport jelen legyen.

configuration GroupSetTest
{
    Import-DscResource -ModuleName PSDesiredStateConfiguration
    Node localhost
    {
        GroupSet GroupSetTest
        {
            GroupName        = @("myGroup", "myOtherGroup")
            Ensure           = "Present"
            MembersToInclude = @("contoso\alice", "contoso\bob")
            MembersToExclude = $("contoso\john")
            Credential       = Get-Credential
        }
    }
}
$cd = @{
    AllNodes = @(
        @{
            NodeName                    = 'localhost'
            PSDscAllowPlainTextPassword = $true
            PSDscAllowDomainUser        = $true
        }
    )
}

GroupSetTest -ConfigurationData $cd

Megjegyzés

Ez a példa egyszerű szöveges hitelesítő adatokat használ az egyszerűség kedvéért. A hitelesítő adatoknak a konfigurációs MOF-fájlban való titkosításáról további információt az MOF-fájl biztonságossá tételével kapcsolatos cikkben talál.