Dela via

Set-Acl

  • Referens
Modul:
Microsoft.PowerShell.Security

Ändrar säkerhetsbeskrivningen för ett angivet objekt, till exempel en fil eller en registernyckel.

Syntax

Set-Acl
   [-Path] <String[]>
   [-AclObject] <Object>
   [-ClearCentralAccessPolicy]
   [-PassThru]
   [-Filter <String>]
   [-Include <String[]>]
   [-Exclude <String[]>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-Acl
   [-InputObject] <PSObject>
   [-AclObject] <Object>
   [-PassThru]
   [-Filter <String>]
   [-Include <String[]>]
   [-Exclude <String[]>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-Acl
   -LiteralPath <String[]>
   [-AclObject] <Object>
   [-ClearCentralAccessPolicy]
   [-PassThru]
   [-Filter <String>]
   [-Include <String[]>]
   [-Exclude <String[]>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Den här cmdleten är endast tillgänglig på Windows-plattformen.

Cmdleten Set-Acl ändrar säkerhetsbeskrivningen för ett angivet objekt, till exempel en fil eller en registernyckel, så att den matchar värdena i en säkerhetsbeskrivning som du anger.

Om du vill använda Set-Aclanvänder du parametern Path eller InputObject för att identifiera det objekt vars säkerhetsbeskrivning du vill ändra. Använd sedan parametrarna AclObject eller SecurityDescriptor för att ange en säkerhetsbeskrivning som har de värden som du vill tillämpa. Set-Acl tillämpar säkerhetsbeskrivningen som anges. Den använder värdet för parametern AclObject som modell och ändrar värdena i objektets säkerhetsbeskrivning för att matcha värdena i parametern AclObject .

Exempel

Exempel 1: Kopiera en säkerhetsbeskrivning från en fil till en annan

$DogACL = Get-Acl -Path "C:\Dog.txt"
Set-Acl -Path "C:\Cat.txt" -AclObject $DogACL

Dessa kommandon kopierar värdena från säkerhetsbeskrivningen för Dog.txt-filen till säkerhetsbeskrivningen för Cat.txt-filen. När kommandona har slutförts är säkerhetsbeskrivningarna för Dog.txt- och Cat.txt-filerna identiska.

Det första kommandot använder cmdleten Get-Acl för att hämta säkerhetsbeskrivningen för filen Dog.txt. Tilldelningsoperatorn (=) lagrar säkerhetsbeskrivningen i värdet för variabeln $DogACL.

Det andra kommandot använder Set-Acl för att ändra värdena i ACL för Cat.txt till värdena i $DogACL.

Värdet för parametern Path är sökvägen till filen Cat.txt. Värdet för parametern AclObject är modell-ACL, i det här fallet ACL för Dog.txt som sparats i variabeln $DogACL .

Exempel 2: Använd pipelineoperatorn för att skicka en beskrivning

Get-Acl -Path "C:\Dog.txt" | Set-Acl -Path "C:\Cat.txt"

Det här kommandot är nästan detsamma som kommandot i föregående exempel, förutom att det använder en pipelineoperator (|) för att skicka säkerhetsbeskrivningen från ett Get-Acl kommando till ett Set-Acl kommando.

Det första kommandot använder cmdleten Get-Acl för att hämta säkerhetsbeskrivningen för filen Dog.txt. Pipelineoperatorn (|) skickar ett objekt som representerar Dog.txt säkerhetsbeskrivning till cmdleten Set-Acl .

Det andra kommandot använder Set-Acl för att tillämpa säkerhetsbeskrivningen för Dog.txt på Cat.txt. När kommandot har slutförts är ACL:erna för Dog.txt- och Cat.txt-filerna identiska.

Exempel 3: Tillämpa en säkerhetsbeskrivning på flera filer

$NewAcl = Get-Acl File0.txt
Get-ChildItem -Path "C:\temp" -Recurse -Include "*.txt" -Force | Set-Acl -AclObject $NewAcl

Dessa kommandon tillämpar säkerhetsbeskrivningarna i File0.txt-filen på alla textfiler i C:\Temp katalogen och alla dess underkataloger.

Det första kommandot hämtar säkerhetsbeskrivningen för File0.txt-filen i den aktuella katalogen och använder tilldelningsoperatorn (=) för att lagra den i variabeln $NewACL .

Det första kommandot i pipelinen använder cmdleten Get-ChildItem för att hämta alla textfiler i C:\Temp katalogen. Parametern Recurse utökar kommandot till alla underkataloger i C:\temp. Parametern Include begränsar de filer som hämtas till dem med filnamnstillägget .txt . Force-parametern hämtar dolda filer, som annars skulle undantas. (Du kan inte använda c:\temp\*.txt, eftersom parametern Recurse fungerar på kataloger, inte på filer.)

Pipelineoperatorn (|) skickar objekten som representerar de hämtade filerna till cmdleten Set-Acl , vilket tillämpar säkerhetsbeskrivningen i parametern AclObject på alla filer i pipelinen.

I praktiken är det bäst att använda parametern WhatIf med alla Set-Acl kommandon som kan påverka mer än ett objekt. I det här fallet skulle det andra kommandot i pipelinen vara Set-Acl -AclObject $NewAcl -WhatIf. Det här kommandot visar de filer som skulle påverkas av kommandot. När du har granskat resultatet kan du köra kommandot igen utan parametern WhatIf .

Exempel 4: Inaktivera arv och bevara ärvda åtkomstregler

$NewAcl = Get-Acl -Path "C:\Pets\Dog.txt"
$isProtected = $true
$preserveInheritance = $true
$NewAcl.SetAccessRuleProtection($isProtected, $preserveInheritance)
Set-Acl -Path "C:\Pets\Dog.txt" -AclObject $NewAcl

Dessa kommandon inaktiverar åtkomstarv från överordnade mappar, samtidigt som befintliga ärvda åtkomstregler bevaras.

Det första kommandot använder cmdleten Get-Acl för att hämta säkerhetsbeskrivningen för filen Dog.txt.

Därefter skapas variabler för att konvertera ärvda åtkomstregler till explicita åtkomstregler. Om du vill skydda åtkomstreglerna som är associerade med detta från arv anger du variabeln $isProtected till $true. Om du vill tillåta arv anger du $isProtected till $false. Mer information finns i ange åtkomstregelskydd.

Ange variabeln $preserveInheritance till $true för att bevara ärvda åtkomstregler eller $false för att ta bort ärvda åtkomstregler. Sedan uppdateras åtkomstregelskyddet med metoden SetAccessRuleProtection().

Det sista kommandot använder Set-Acl för att tillämpa säkerhetsbeskrivningen för på Dog.txt. När kommandot har slutförts tillämpas ACL:erna för Dog.txt som ärvdes från mappen Husdjur direkt på Dog.txt, och nya åtkomstprinciper som läggs till i Husdjur ändrar inte åtkomsten till Dog.txt.

Exempel 5: Ge administratörer fullständig kontroll över filen

$NewAcl = Get-Acl -Path "C:\Pets\Dog.txt"
# Set properties
$identity = "BUILTIN\Administrators"
$fileSystemRights = "FullControl"
$type = "Allow"
# Create new rule
$fileSystemAccessRuleArgumentList = $identity, $fileSystemRights, $type
$fileSystemAccessRule = New-Object -TypeName System.Security.AccessControl.FileSystemAccessRule -ArgumentList $fileSystemAccessRuleArgumentList
# Apply new rule
$NewAcl.SetAccessRule($fileSystemAccessRule)
Set-Acl -Path "C:\Pets\Dog.txt" -AclObject $NewAcl

Det här kommandot ger gruppen BUILTIN\Administrators fullständig kontroll över filen Dog.txt.

Det första kommandot använder cmdleten Get-Acl för att hämta säkerhetsbeskrivningen för filen Dog.txt.

Nästa variabler skapas för att ge gruppen BUILTIN\Administrators fullständig kontroll över filen Dog.txt. Variabeln $identity anges till namnet på ett användarkonto. Variabeln $fileSystemRights är inställd på FullControl och kan vara något av de FileSystemRights-värden som anger vilken typ av åtgärd som är associerad med åtkomstregeln. Variabeln $type inställd på "Tillåt" anger om åtgärden ska tillåtas eller nekas. Variabeln $fileSystemAccessRuleArgumentList är en argumentlista som ska skickas när det nya FileSystemAccessRule-objektet skapas. Sedan skapas ett nytt FileSystemAccessRule-objekt och FileSystemAccessRule-objektet skickas till metoden SetAccessRule() och lägger till den nya åtkomstregeln.

Det sista kommandot använder Set-Acl för att tillämpa säkerhetsbeskrivningen för på Dog.txt. När kommandot har slutförts har gruppen BUILTIN\Administrators fullständig kontroll över Dog.txt.

Parametrar

-AclObject

Anger en ACL med önskade egenskapsvärden. Set-Acl ändrar ACL för objektet som anges av parametern Path eller InputObject så att det matchar värdena i det angivna säkerhetsobjektet.

Du kan spara utdata från ett Get-Acl kommando i en variabel och sedan använda parametern AclObject för att skicka variabeln eller skriva ett Get-Acl kommando.

Typ:Object
Position:1
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-ClearCentralAccessPolicy

Tar bort den centrala åtkomstprincipen från det angivna objektet.

Från och med Windows Server 2012 kan administratörer använda Active Directory och grupprincip för att ange centrala åtkomstprinciper för användare och grupper. Mer information finns i Dynamisk åtkomstkontroll: Scenarioöversikt.

Den här parametern introducerades i Windows PowerShell 3.0.

Typ:SwitchParameter
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

Typ:SwitchParameter
Alias:cf
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Exclude

Utelämnar de angivna objekten. Värdet för den här parametern kvalificerar parametern Path . Ange ett sökvägselement eller mönster, till exempel *.txt. Jokertecken tillåts.

Typ:String[]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:True

-Filter

Anger ett filter i providerns format eller språk. Värdet för den här parametern kvalificerar parametern Path . Syntaxen för filtret, inklusive användningen av jokertecken, beror på providern. Filter är effektivare än andra parametrar eftersom providern tillämpar dem när objekten hämtas, i stället för att PowerShell filtrerar objekten när de har hämtats.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:True

-Include

Ändrar endast de angivna objekten. Värdet för den här parametern kvalificerar parametern Path . Ange ett sökvägselement eller mönster, till exempel *.txt. Jokertecken tillåts.

Typ:String[]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:True

-InputObject

Ändrar säkerhetsbeskrivningen för det angivna objektet. Ange en variabel som innehåller objektet eller ett kommando som hämtar objektet.

Du kan inte skicka det objekt som ska ändras till Set-Acl. Använd i stället parametern InputObject explicit i kommandot .

Den här parametern introducerades i Windows PowerShell 3.0.

Typ:PSObject
Position:0
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-LiteralPath

Ändrar säkerhetsbeskrivningen för det angivna objektet. Till skillnad från Path används värdet för parametern LiteralPath precis som det skrivs. Inga tecken tolkas som jokertecken. Om sökvägen innehåller escape-tecken omger du den med enkla citattecken ('). Enkla citattecken gör att PowerShell inte tolkar några tecken som escape-sekvenser.

Den här parametern introducerades i Windows PowerShell 3.0.

Typ:String[]
Alias:PSPath
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-PassThru

Returnerar ett objekt som representerar säkerhetsbeskrivningen som ändrades. Som standard genererar den här cmdleten inga utdata.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Path

Ändrar säkerhetsbeskrivningen för det angivna objektet. Ange sökvägen till ett objekt, till exempel en sökväg till en fil eller registernyckel. Jokertecken tillåts.

Om du skickar ett säkerhetsobjekt till Set-Acl (antingen med hjälp av parametrarna AclObject eller SecurityDescriptor eller genom att skicka ett säkerhetsobjekt från Get-Acl till Set-Acl) och du utelämnar parametern Path (namn och värde) Set-Acl använder du sökvägen som ingår i säkerhetsobjektet.

Typ:String[]
Position:0
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:True

-WhatIf

Visar vad som skulle hända om cmdleten kördes. Cmdleten körs inte.

Typ:SwitchParameter
Alias:wi
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

Indata

ObjectSecurity

Du kan skicka ett ACL-objekt till den här cmdleten.

CommonSecurityDescriptor

Du kan skicka en säkerhetsbeskrivning till den här cmdleten.

Utdata

None

Som standard returnerar den här cmdleten inga utdata.

FileSecurity

När du använder parametern PassThru returnerar den här cmdleten ett säkerhetsobjekt. Typen av säkerhetsobjekt beror på typen av objekt.

Kommentarer

Den här cmdleten är endast tillgänglig på Windows-plattformar.

Cmdleten Set-Acl stöds av PowerShell-filsystemet och registerprovidrar. Därför kan du använda den för att ändra säkerhetsbeskrivningarna för filer, kataloger och registernycklar.