Set-AzureVMDscExtension

Odwołanie

Moduł:: Azure

Konfiguruje rozszerzenie DSC na maszynie wirtualnej.

Uwaga

Polecenia cmdlet, do których odwołuje się ta dokumentacja, służą do zarządzania starszymi zasobami platformy Azure korzystającymi z interfejsów API programu Azure Service Manager (ASM). Ten starszy moduł programu PowerShell nie jest zalecany podczas tworzenia nowych zasobów, ponieważ usługa ASM ma zostać wycofana. Aby uzyskać więcej informacji, zobacz Wycofywanie programu Azure Service Manager.

Moduł Az programu PowerShell jest zalecanym modułem programu PowerShell do zarządzania zasobami usługi Azure Resource Manager (ARM) przy użyciu programu PowerShell.

Składnia

Set-AzureVMDscExtension
   [-ReferenceName <String>]
   [-ConfigurationArgument <Hashtable>]
   [-ConfigurationDataPath <String>]
   [-ConfigurationArchive] <String>
   [-ConfigurationName <String>]
   [-ContainerName <String>]
   [-Force]
   [-StorageContext <AzureStorageContext>]
   [-Version <String>]
   [-StorageEndpointSuffix <String>]
   [-WmfVersion <String>]
   [-DataCollection <String>]
   -VM <IPersistentVM>
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Opis

Polecenie cmdlet Set-AzureVMDscExtension konfiguruje rozszerzenie Desired State Configuration (DSC) na maszynie wirtualnej.

Przykłady

Przykład 1. Konfigurowanie rozszerzenia DSC na maszynie wirtualnej

PS C:\> Set-AzureVMDscExtension -VM $VM -ConfigurationArchive MyConfiguration.ps1.zip  -ConfigurationName MyConfiguration -ConfigurationArgument @{ Path = 'C:\MyDirectory' }
DeploymentName              : my-vm-svc
Name                        : my-vm
Label                       :
VM                          : Microsoft.WindowsAzure.Commands.ServiceManagement.Model.PersistentVM
InstanceStatus              : ReadyRole
IpAddress                   : 10.10.10.10
InstanceStateDetails        :
PowerState                  : Started
InstanceErrorCode           :
InstanceFaultDomain         : 0
InstanceName                : my-vm
InstanceUpgradeDomain       : 0
InstanceSize                : Small
AvailabilitySetName         :
DNSName                     : http://my-vm-svc.cloudapp.net/
Status                      : ReadyRole
GuestAgentStatus            : Microsoft.WindowsAzure.Commands.ServiceManagement.Model.PersistentVMModel.GuestAgentStatus
ResourceExtensionStatusList : {Contoso.Compute.BGInfo}
PublicIPAddress             :
PublicIPName                :
ServiceName                 : my-vm-svc
OperationDescription        : Get-AzureVM
OperationId                 : a0217a7af900c1f8a212299a3333cdbd6
OperationStatus             : OK

To polecenie konfiguruje rozszerzenie DSC na maszynie wirtualnej.

Pakiet MyConfiguration.ps1.zip musi zostać wcześniej przekazany do usługi Azure Storage przy użyciu polecenia Publish-AzureVMDscConfiguration i zawiera skrypt MyConfiguration.ps1 i moduły, od których zależy.

Argument MyConfiguration wskazuje konkretną konfigurację DSC w ramach skryptu do wykonania. Parametr -ConfigurationArgument określa tabelę skrótu z argumentami przekazywanymi do funkcji konfiguracji.

Przykład 2. Konfigurowanie rozszerzenia DSC na maszynie wirtualnej przy użyciu ścieżki do danych konfiguracji

PS C:\> $VM | Set-AzureVMDscExtension -ConfigurationArchive MyConfiguration.ps1.zip  -ConfigurationName MyConfiguration -ConfigurationArgument @{ Credential = Get-Credential } -ConfigurationDataPath MyConfigurationData.psd1
DeploymentName              : my-vm-svc
Name                        : my-vm
Label                       :
VM                          : Microsoft.WindowsAzure.Commands.ServiceManagement.Model.PersistentVM
InstanceStatus              : ReadyRole
IpAddress                   : 10.10.10.10
InstanceStateDetails        :
PowerState                  : Started
InstanceErrorCode           :
InstanceFaultDomain         : 0
InstanceName                : my-vm
InstanceUpgradeDomain       : 0
InstanceSize                : Small
AvailabilitySetName         :
DNSName                     : http://my-vm-svc.cloudapp.net/
Status                      : ReadyRole
GuestAgentStatus            : Microsoft.WindowsAzure.Commands.ServiceManagement.Model.PersistentVMModel.GuestAgentStatus
ResourceExtensionStatusList : {Microsoft.Compute.BGInfo, Microsoft.Powershell.DSC}
PublicIPAddress             :
PublicIPName                :
ServiceName                 : my-vm-svc
OperationDescription        : Get-AzureVM
OperationId                 : a0217a7af900c1f8a212299a3333cdbd7
OperationStatus             : OK

To polecenie konfiguruje rozszerzenie DSC na maszynie wirtualnej przy użyciu ścieżki do danych konfiguracji.

Parametry

-ConfigurationArchive

Określa nazwę pakietu konfiguracji (.zip pliku), który został wcześniej przekazany przez polecenie Publish-AzureVMDscConfiguration. Ten parametr musi określać tylko nazwę pliku bez żadnej ścieżki.

Typ:	String
Position:	1
wartość domyślna:	None
Wymagane:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-ConfigurationArgument

Określa tabelę skrótu określającą argumenty funkcji konfiguracji. Klucze odpowiadają nazwam parametrów i wartościom wartości parametrów.

Dopuszczalne wartości tego parametru to:

typy pierwotne
string
tablica
PsCredential

Typ:	Hashtable
Position:	Named
wartość domyślna:	None
Wymagane:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-ConfigurationDataPath

Określa ścieżkę pliku psd1, który określa dane funkcji konfiguracji. Ten plik musi zawierać tabelę skrótów zgodnie z opisem w temacie Oddzielanie konfiguracji i danych środowiskahttps://msdn.microsoft.com/en-us/PowerShell/DSC/configData.

Typ:	String
Position:	Named
wartość domyślna:	None
Wymagane:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-ConfigurationName

Określa nazwę skryptu konfiguracji lub modułu wywoływanego przez rozszerzenie DSC.

Wartość tego parametru musi być nazwą jednej z funkcji konfiguracji zawartych w skryptach lub modułach spakowanych w konfiguracjiArchive.

To polecenie cmdlet domyślnie określa nazwę pliku podanego przez parametr ConfigurationArchive , jeśli pominięto ten parametr, z wyłączeniem dowolnego rozszerzenia. Na przykład jeśli parametr ConfigurationArchive to "SalesWebSite.ps1.zip", wartość domyślna parametru ConfigurationName to "SalesWebSite".

Typ:	String
Position:	Named
wartość domyślna:	None
Wymagane:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

Typ:	SwitchParameter
Aliases:	cf
Position:	Named
wartość domyślna:	False
Wymagane:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ContainerName

Określa nazwę kontenera usługi Azure Storage, w którym znajduje się configurationArchive .

Typ:	String
Position:	Named
wartość domyślna:	None
Wymagane:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-DataCollection

Typ:	String
Position:	Named
wartość domyślna:	None
Wymagane:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Force

Wskazuje, że to polecenie cmdlet zastępuje istniejące obiekty blob.

Typ:	SwitchParameter
Position:	Named
wartość domyślna:	None
Wymagane:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-InformationAction

Określa, jak to polecenie cmdlet reaguje na zdarzenie informacyjne.

Dopuszczalne wartości tego parametru to:

Kontynuuj
Ignoruj
Zapytać
SilentlyContinue
Zatrzymaj
Wstrzymanie

Typ:	ActionPreference
Aliases:	infa
Position:	Named
wartość domyślna:	None
Wymagane:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-InformationVariable

Określa zmienną informacyjną.

Typ:	String
Aliases:	iv
Position:	Named
wartość domyślna:	None
Wymagane:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Profile

Określa profil platformy Azure, z którego to polecenie cmdlet odczytuje. Jeśli nie określisz profilu, to polecenie cmdlet odczytuje z lokalnego profilu domyślnego.

Typ:	AzureSMProfile
Position:	Named
wartość domyślna:	None
Wymagane:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ReferenceName

Określa ciąg zdefiniowany przez użytkownika, który może służyć do odwoływania się do rozszerzenia. Ten parametr jest określony, gdy rozszerzenie jest dodawane do maszyny wirtualnej po raz pierwszy. W przypadku kolejnych aktualizacji należy określić wcześniej używaną nazwę odwołania podczas aktualizowania rozszerzenia. Nazwa ReferenceName przypisana do rozszerzenia jest zwracana przy użyciu polecenia cmdlet Get-AzureVM .

Typ:	String
Position:	Named
wartość domyślna:	None
Wymagane:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-StorageContext

Określa kontekst usługi Azure Storage, który zapewnia ustawienia zabezpieczeń używane do uzyskiwania dostępu do skryptu konfiguracji. Ten kontekst zapewnia dostęp do odczytu do kontenera określonego przez parametr ContainerName .

Typ:	AzureStorageContext
Position:	Named
wartość domyślna:	None
Wymagane:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-StorageEndpointSuffix

Określa sufiks punktu końcowego DNS dla wszystkich usług magazynu, na przykład "core.contoso.net".

Typ:	String
Position:	Named
wartość domyślna:	None
Wymagane:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Version

Określa określoną wersję rozszerzenia DSC do użycia. Wartość domyślna jest ustawiona na wartość "1.*", jeśli ten parametr nie jest określony.

Typ:	String
Position:	Named
wartość domyślna:	None
Wymagane:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-VM

Określa trwały obiekt maszyny wirtualnej.

Typ:	IPersistentVM
Aliases:	InputObject
Position:	Named
wartość domyślna:	None
Wymagane:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-WhatIf

Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie zostało uruchomione.

Typ:	SwitchParameter
Aliases:	wi
Position:	Named
wartość domyślna:	False
Wymagane:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WmfVersion

Określa wersję programu Windows Management Framework (WMF) do zainstalowania na maszynie wirtualnej. Rozszerzenie DSC zależy od funkcji DSC, które są dostępne tylko w aktualizacjach WMF. Ten parametr określa wersję aktualizacji do zainstalowania na maszynie wirtualnej. Dopuszczalne wartości tego parametru to:

4.0. Instaluje program WMF 4.0, chyba że jest już zainstalowana nowsza wersja.
5.0. Instaluje najnowszą wersję programu WMF 5.0.
najnowszy. Instaluje najnowszą wersję programu WMF, obecnie WMF 5.0.

Wartość domyślna to najnowsza.

Typ:	String
Position:	Named
wartość domyślna:	None
Wymagane:	False
Accept pipeline input:	True
Accept wildcard characters:	False

Udostępnij za pośrednictwem

Set-AzureVMDscExtension

Składnia

Opis

Przykłady

Przykład 1. Konfigurowanie rozszerzenia DSC na maszynie wirtualnej

Przykład 2. Konfigurowanie rozszerzenia DSC na maszynie wirtualnej przy użyciu ścieżki do danych konfiguracji

Parametry

-ConfigurationArchive

-ConfigurationArgument

-ConfigurationDataPath

-ConfigurationName

-Confirm

-ContainerName

-DataCollection

-Force

-InformationAction

-InformationVariable

-Profile

-ReferenceName

-StorageContext

-StorageEndpointSuffix

-Version

-VM

-WhatIf

-WmfVersion

Dodatkowe zasoby

Udostępnij za pośrednictwem

Set-AzureVMDscExtension

Składnia

Opis

Przykłady

Przykład 1. Konfigurowanie rozszerzenia DSC na maszynie wirtualnej

Przykład 2. Konfigurowanie rozszerzenia DSC na maszynie wirtualnej przy użyciu ścieżki do danych konfiguracji

Parametry

-ConfigurationArchive

-ConfigurationArgument

-ConfigurationDataPath

-ConfigurationName

-Confirm

-ContainerName

-DataCollection

-Force

-InformationAction

-InformationVariable

-Profile

-ReferenceName

-StorageContext

-StorageEndpointSuffix

-Version

-VM

-WhatIf

-WmfVersion

Linki powiązane

Dodatkowe zasoby