New-AzPolicyAttestation

Referenz

Modul:: Az.PolicyInsights

Erstellt einen neuen Richtliniennachweis für eine Richtlinienzuweisung.

Syntax

New-AzPolicyAttestation
   -Name <String>
   [-Scope <String>]
   [-ResourceGroupName <String>]
   -PolicyAssignmentId <String>
   [-ComplianceState <String>]
   [-PolicyDefinitionReferenceId <String>]
   [-ExpiresOn <DateTime>]
   [-Owner <String>]
   [-Comment <String>]
   [-Evidence <PSAttestationEvidence[]>]
   [-AssessmentDate <DateTime>]
   [-Metadata <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzPolicyAttestation
   -ResourceId <String>
   -PolicyAssignmentId <String>
   [-ComplianceState <String>]
   [-PolicyDefinitionReferenceId <String>]
   [-ExpiresOn <DateTime>]
   [-Owner <String>]
   [-Comment <String>]
   [-Evidence <PSAttestationEvidence[]>]
   [-AssessmentDate <DateTime>]
   [-Metadata <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Beschreibung

Die New-AzPolicyAttestation Cmdlet erstellt einen Richtliniennachweis für eine bestimmte Richtlinienzuweisung. Nachweise werden von Azure-Richtlinien verwendet, um Compliancestatus von Ressourcen oder Bereichen festzulegen, die von manuellen Richtlinien bestimmt werden. Sie ermöglichen es Benutzern auch, zusätzliche Metadaten bereitzustellen oder mit Nachweisen zu verknüpfen, die dem nachweisten Compliancestatus beigefügt sind.

Beispiele

Beispiel 1: Erstellen eines Nachweises im Abonnementbereich

Set-AzContext -Subscription "d1acb22b-c876-44f7-b08e-3fcf9f6767f4"
$policyAssignmentId = "/subscriptions/d1acb22b-c876-44f7-b08e-3fcf9f6767f4/providers/microsoft.authorization/policyassignments/psattestationsubassignment"
$attestationName = "attestation-subscription"
New-AzPolicyAttestation -PolicyAssignmentId $policyAssignmentId -Name $attestationName -ComplianceState "Compliant"

Id                          : /subscriptions/d1acb22b-c876-44f7-b08e-3fcf9f6767f4/providers/microsoft.policyinsights
                              /attestations/attestation-subscription
Name                        : attestation-subscription
Type                        : Microsoft.PolicyInsights/attestations
PolicyAssignmentId          : /subscriptions/d1acb22b-c876-44f7-b08e-3fcf9f6767f4/providers/microsoft.authorization/
                              policyassignments/psattestationsubassignment
PolicyDefinitionReferenceId :
ComplianceState             : Compliant
ExpiresOn                   :
Owner                       :
Comment                     :
Evidence                    :
ProvisioningState           : Succeeded
LastComplianceStateChangeAt : 1/27/2023 2:26:24 AM
AssessmentDate              :
Metadata                    :
SystemData                  :

Dieser Befehl erstellt einen neuen Richtliniennachweis für das Abonnement "d1acb22b-c876-44f7-b08e-3fcf9f6767f4" für die angegebene Richtlinienzuweisung.

Hinweis: Dieser Befehl erstellt einen Nachweis für das Abonnement und nicht die darunter liegenden Ressourcen. Um die Verwaltung zu vereinfachen, sollten manuelle Richtlinien so konzipiert werden, dass sie auf den Bereich abzielen, der die Grenze von Ressourcen definiert, deren Compliancestatus bestätigt werden muss. In diesem Fall sollte die manuelle Richtlinie auf Microsoft.Resources/subscriptionsausgerichtet sein. Weitere Informationen hierzu https://learn.microsoft.com/en-us/azure/governance/policy/concepts/attestation-structure, um die bewährten Methoden zum Erstellen von Nachweisen zu verstehen.

Beispiel 2: Erstellen eines Nachweises in der Ressourcengruppe

$policyAssignmentId = "/subscriptions/d1acb22b-c876-44f7-b08e-3fcf9f6767f4/providers/microsoft.authorization/policyassignments/psattestationrgassignment"
$attestationName = "attestation-RG"
$rgName = "ps-attestation-test-rg"
New-AzPolicyAttestation -ResourceGroupName $RGName -PolicyAssignmentId $policyAssignmentId -Name $attestationName -ComplianceState "Compliant"

Id                          : /subscriptions/d1acb22b-c876-44f7-b08e-3fcf9f6767f4/resourcegroups/ps-attestation-test
                              -rg/providers/microsoft.policyinsights/attestations/attestation-rg
Name                        : attestation-RG
Type                        : Microsoft.PolicyInsights/attestations
PolicyAssignmentId          : /subscriptions/d1acb22b-c876-44f7-b08e-3fcf9f6767f4/providers/microsoft.authorization/
                              policyassignments/psattestationrgassignment
PolicyDefinitionReferenceId :
ComplianceState             : Compliant
ExpiresOn                   :
Owner                       :
Comment                     :
Evidence                    :
ProvisioningState           : Succeeded
LastComplianceStateChangeAt : 1/27/2023 2:35:28 AM
AssessmentDate              :
Metadata                    :
SystemData                  :

Dieser Befehl erstellt einen neuen Richtliniennachweis in der Ressourcengruppe "ps-attestation-test-rg" für die angegebene Richtlinienzuweisung.

Hinweis: Dieser Befehl erstellt einen Nachweis für die Ressourcengruppe und nicht die darunter liegenden Ressourcen. Um die Verwaltung zu vereinfachen, sollten manuelle Richtlinien so konzipiert werden, dass sie auf den Bereich abzielen, der die Grenze von Ressourcen definiert, deren Compliancestatus bestätigt werden muss. In diesem Fall sollte die manuelle Richtlinie auf Microsoft.Resources/subscriptions/resourceGroupsausgerichtet sein. Weitere Informationen hierzu https://learn.microsoft.com/en-us/azure/governance/policy/concepts/attestation-structure, um die bewährten Methoden zum Erstellen von Nachweisen zu verstehen.

Beispiel 3: Erstellen eines Nachweises bei der Ressource

$policyAssignmentId = "/subscriptions/d1acb22b-c876-44f7-b08e-3fcf9f6767f4/providers/microsoft.authorization/policyassignments/psattestationresourceassignment"
$attestationName = "attestation-resource"
$scope = "/subscriptions/d1acb22b-c876-44f7-b08e-3fcf9f6767f4/resourceGroups/ps-attestation-test-rg/providers/Microsoft.Network/networkSecurityGroups/pstests0"
New-AzPolicyAttestation `
    -PolicyAssignmentId $policyAssignmentId `
    -Name $attestationName `
    -Scope $scope `
    -ComplianceState "NonCompliant"

Id                          : /subscriptions/d1acb22b-c876-44f7-b08e-3fcf9f6767f4/resourcegroups/ps-attestation-test
                              -rg/providers/microsoft.network/networksecuritygroups/pstests0/providers/microsoft.pol
                              icyinsights/attestations/attestation-resource
Name                        : attestation-resource
Type                        : Microsoft.PolicyInsights/attestations
PolicyAssignmentId          : /subscriptions/d1acb22b-c876-44f7-b08e-3fcf9f6767f4/providers/microsoft.authorization/
                              policyassignments/psattestationresourceassignment
PolicyDefinitionReferenceId :
ComplianceState             : NonCompliant
ExpiresOn                   :
Owner                       :
Comment                     :
Evidence                    :
ProvisioningState           : Succeeded
LastComplianceStateChangeAt : 1/27/2023 2:38:17 AM
AssessmentDate              :
Metadata                    :
SystemData                  :

Dieser Befehl erstellt einen Nachweis für die Ressource "pstests0" für die angegebene Richtlinienzuordnung.

Beispiel 4: Erstellen eines Nachweises mit allen Eigenschaften in der Ressourcengruppe

$attestationName = "attestationRGAllProps"
$policyInitiativeAssignmentId = "/subscriptions/d1acb22b-c876-44f7-b08e-3fcf9f6767f4/providers/microsoft.authorization/policyassignments/psattestationinitiativergassignment"

$policyDefinitionReferenceId = "PSTestAttestationRG_1"
$RGName = "ps-attestation-test-rg"
$description = "This is a test description"
$sourceURI = "https://contoso.org/test.pdf"
$evidence = @{
    "Description"=$description
    "SourceUri"=$sourceURI
}
$policyEvidence = @($evidence)
$owner = "Test Owner"
$expiresOn = [datetime]::UtcNow.AddYears(1)
$metadata = '{"TestKey":"TestValue"}'

New-AzPolicyAttestation `
    -Name $attestationName `
    -ResourceGroupName $RGName `
    -PolicyAssignmentId $policyInitiativeAssignmentId `
    -PolicyDefinitionReferenceId $policyDefinitionReferenceId `
    -ComplianceState $Compliant `
    -Comment $comment `
    -Evidence $policyEvidence `
    -ExpiresOn $expiresOn `
    -AssessmentDate $expiresOn.AddDays(-2) `
    -Owner $owner `
    -Metadata $metadata

Id                          : /subscriptions/d1acb22b-c876-44f7-b08e-3fcf9f6767f4/resourcegroups/ps-attestation-test
                              -rg/providers/microsoft.policyinsights/attestations/attestationrgallprops
Name                        : attestationRGAllProps
Type                        : Microsoft.PolicyInsights/attestations
PolicyAssignmentId          : /subscriptions/d1acb22b-c876-44f7-b08e-3fcf9f6767f4/providers/microsoft.authorization/
                              policyassignments/psattestationinitiativergassignment
PolicyDefinitionReferenceId : pstestattestationrg_1
ComplianceState             :
ExpiresOn                   : 1/27/2024 2:51:54 AM
Owner                       : Test Owner
Comment                     :
Evidence                    : {Microsoft.Azure.Commands.PolicyInsights.Models.Attestations.PSAttestationEvidence}
ProvisioningState           : Succeeded
LastComplianceStateChangeAt : 1/27/2023 2:51:57 AM
AssessmentDate              : 1/25/2024 2:51:54 AM
Metadata                    : {
                                "TestKey": "TestValue"
                              }
SystemData                  :

Parameter

-AssessmentDate

Zeitpunkt der Prüfung des Nachweises.

Typ:	Nullable<T>[DateTime]
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	True
Platzhalterzeichen akzeptieren:	False

-Comment

Kommentare, die beschreiben, warum diese Bescheinigung erstellt wurde.

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	True
Platzhalterzeichen akzeptieren:	False

-ComplianceState

Der Compliancestatus der Ressource. Z. B. "Kompatibel", "Nicht konform", "Unbekannt"

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	True
Platzhalterzeichen akzeptieren:	False

-Confirm

Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.

Typ:	SwitchParameter
Aliase:	cf
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-DefaultProfile

Die Anmeldeinformationen, Konten, Mandanten und Abonnements, die für die Kommunikation mit Azure verwendet werden.

Typ:	IAzureContextContainer
Aliase:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Evidence

Die Nachweise, die den in diesem Nachweis festgelegten Konformitätsstatus unterstützen.

Typ:	PSAttestationEvidence[]
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	True
Platzhalterzeichen akzeptieren:	False

-ExpiresOn

Der Zeitpunkt, zu dem der im Nachweis festgelegte Konformitätsstatus abläuft.

Typ:	Nullable<T>[DateTime]
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	True
Platzhalterzeichen akzeptieren:	False

-Metadata

Zusätzliche Metadaten für den Nachweis.

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	True
Platzhalterzeichen akzeptieren:	False

-Name

Ressourcenname.

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	True
Platzhalterzeichen akzeptieren:	False

-Owner

Die Person, die für das Festlegen des Status der Ressource verantwortlich ist. Dieser Wert ist in der Regel eine Microsoft Entra-Objekt-ID.

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	True
Platzhalterzeichen akzeptieren:	False

-PolicyAssignmentId

Richtlinienzuweisungs-ID. Beispiel: "/subscriptions/{subscriptionId}/providers/Microsoft.Authorization/policyAssignments/{assignmentName}".

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	True
Platzhalterzeichen akzeptieren:	False

-PolicyDefinitionReferenceId

Die Richtliniendefinitionsreferenz-ID der einzelnen Definition. Erforderlich, wenn die Richtlinienzuweisung eine Richtliniensatzdefinition zuweist.

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	True
Platzhalterzeichen akzeptieren:	False

-ResourceGroupName

Ressourcengruppenname.

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	True
Platzhalterzeichen akzeptieren:	False

-ResourceId

Ressourcen-ID.

Typ:	String
Aliase:	Id
Position:	Named
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	True
Platzhalterzeichen akzeptieren:	False

-Scope

Bereich der Ressource. Beispiel: "/subscriptions/{subscriptionId}/resourceGroups/{rgName}".

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	True
Platzhalterzeichen akzeptieren:	False

-WhatIf

Zeigt, was passiert, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Typ:	SwitchParameter
Aliase:	wi
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

Eingaben

String

Nullable<T>[[System.DateTime, System.Private.CoreLib, Version=7.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]]

PSAttestationEvidence[]

Object

Ausgaben

PSAttestation

Freigeben über

New-AzPolicyAttestation

Syntax

Beschreibung

Beispiele

Beispiel 1: Erstellen eines Nachweises im Abonnementbereich

Beispiel 2: Erstellen eines Nachweises in der Ressourcengruppe

Beispiel 3: Erstellen eines Nachweises bei der Ressource

Beispiel 4: Erstellen eines Nachweises mit allen Eigenschaften in der Ressourcengruppe

Parameter

-AssessmentDate

-Comment

-ComplianceState

-Confirm

-DefaultProfile

-Evidence

-ExpiresOn

-Metadata

-Name

-Owner

-PolicyAssignmentId

-PolicyDefinitionReferenceId

-ResourceGroupName

-ResourceId

-Scope

-WhatIf

Eingaben

Ausgaben

Zusätzliche Ressourcen

Freigeben über

New-AzPolicyAttestation

Syntax

Beschreibung

Beispiele

Beispiel 1: Erstellen eines Nachweises im Abonnementbereich

Beispiel 2: Erstellen eines Nachweises in der Ressourcengruppe

Beispiel 3: Erstellen eines Nachweises bei der Ressource

Beispiel 4: Erstellen eines Nachweises mit allen Eigenschaften in der Ressourcengruppe

Parameter

-AssessmentDate

-Comment

-ComplianceState

-Confirm

-DefaultProfile

-Evidence

-ExpiresOn

-Metadata

-Name

-Owner

-PolicyAssignmentId

-PolicyDefinitionReferenceId

-ResourceGroupName

-ResourceId

-Scope

-WhatIf

Eingaben

Ausgaben

Ähnliche Themen

Zusätzliche Ressourcen